在Visual Studio Code中设置QMK开发环境

Visual Studio Code (VS Code) 是一款支援非常多种不同编程语言的开源编辑器。

相比于使用简陋的文本编辑器，形如VS Code这样的多功能编辑器有诸多优势，比如：

智能的代码补全
便捷的代码导航
重构工具
自动化构建支持（不再需要命令行操作）
图形化的GIT界面
调试器、代码格式化、显示调用层级等多种工具

本章节旨在阐述如何配置VS Code以在其上进行QMK固件开发。

这份指引提供了在Windows及Ubuntu 18.04下所有的配置方法。

配置VS Code

一开始，你需要首先确认所有的构建工具已经安装配置完成，且QMK Firmware仓库已拷贝至本地。前往参阅新人指引确保已完成初始配置。

Windows

依赖项

Git for Windows (该链接会自动提示你保存或运行安装包)
1. 除 Git LFS (Large File Support)（大文件支援） 及 Check daily for Git for Windows updates（每天检查更新） 外取消所有可选项。
2. 将默认编辑器改为 Use Visual Studio Code as Git's default editor（将VS Code作为默认编辑器）
3. 选择 Use Git from Git Bash only（仅在Git Bash中使用Git），这是应使用的方案。
4. 在 Choosing HTTPS transport backend（选择HTTPS传输服务） 选项上，皆可。
5. 选择 Checkout as-is, commit Unix-style line endings（检出不作更改，提交时使用Unix风格换行符），QMK仓库使用的是Unix style提交。
6. 在额外选项页，保持默认选择即可。
该软件是VS Code支持Git的所需项目，是有可能不去使用它，但直接用它会省很多事。
Git Credential Manager for Windows（Windows版Git凭据管理器）（可选）

该软件提供了更好的git 凭据加密存储、多因素身份认证（MFA）及私有访问token生成器。

这个不是严格必须的，但我们依旧推荐使用。

安装VS Code

到VS Code下载安装包
运行安装包

很简单的操作。然而，仍有一些配置我们需要确保是设置正确的。

VS Code设置

首先来配置IntelliSense，虽不是严格必要的，但能让你后续使用便捷很多。首先，在QMK Firmware目录下创建文件 .vscode/c_cpp_properties.json，之后的操作可以手动完成，但我已经完成了大部分。

获取这份文件，如果你的MSYS2没有安装在默认路径，或在用WSL/LxSS，你可能需要做一下编辑修改。

在保存妥当后，如果你有已打开的VS Code，你需要reload一下。

?> 在 .vscode 目录下你应该还能看到 extensions.json 和 settings.json 文件。

现在，我们配置MSYS2作为VSCode的集成终端。这么做有很多好处，最主要的是可以通过按住control点击错误消息直接跳转到文件，调试起来会简单得多，另外的好处是，你不用在窗口间切换。

点击 文件 > 首选项 > > 设置
点击上方右侧的 {} 按钮，打开 settings.json 文件。

将文件改为：

{
     "terminal.integrated.profiles.windows": {
         "QMK_MSYS": {
             "path": "C:/QMK_MSYS/usr/bin/bash.exe",
             "env": {
                 "MSYSTEM": "MINGW64",
                 "CHERE_INVOKING": "1"
             },
             "args": ["--login"]
         }
     },

     "terminal.integrated.cursorStyle": "line"
 }

如果该文件内已经有一些配置项，将上面的内容粘贴在最外层的花括号内，并用一个逗号将新旧内容分隔开。

?> 如果你的MSYS2安装在不同的目录下，你需要将 terminal.integrated.shell.windows 更改为你系统中正确的目录。

点击Ctrl-` (Grave) 或在 视图 > 终端 可以打开终端界面 (workbench.action.terminal.toggleTerminal 命令)。如果没有终端它会自动打开一个。

终端应启动于工程目录中（即 qmk_firmware 目录），之后你可以构建键盘了。

其它系统

到VS Code下载安装包
运行安装包
搞定

是的，确实是搞定了。安装的时候所有所需的路径配置都会被包含进来，在检查当前工程文件并进行IntelliSense解析上表现也会更好。

插件

有一些你可能感兴趣的扩展可以安装：

Git Extension Pack - 提供了一系列的Git工具可以让你在QMK Firmware中使用Git便捷一些。
EditorConfig for VS Code - [可选] - 可以让你的代码更符合QMK规范。
Bracket Pair Colorizer 2 - [可选] - 可以给大括号着色，可以更好地阅读嵌套代码。
GitHub Markdown Preview - [可选] - 使得VS Code下的markdown预览更符合Github的效果。
VS Live Share Extension Pack - [可选] - 这个扩展允许他人访问你的工作区（或反之）进行协作，在你遇到问题需要他人帮助时挺有用。
VIM Keymap - [可选] - 为那些更喜欢VIM风格的按键操作的人所准备。这样的扩展还有挺多。

安装扩展后需要重启VS Code。

配置VS Code下的QMK

点击 文件 > 打开目录
打开你从Github克隆的QMK固件仓库所在目录。
点击 文件 > 保存工作区为...

6.4 KiB Raw Blame History Unescape Escape