VSCode 个人使用经验

Version 1.01

by Pixel Frame
遠神恵賜

编辑器介绍

资源管理

VS Code自然是可以作为一个单纯的文本编辑器，直接打开文档进行编辑。但其实要使用Debug、Git等功能，则还是要打开一个文件夹，即将该文件夹作为工作目录。这也就和IDE的工程类似的概念。在打开文件夹后，左侧的资源管理器就能很直观的显示目录中的各种文件。在安装插件后，更是能够添加XML分析，Git历史，Commit对比等等的功能。

编码/制表符/换行符

VS Code新建/打开文件默认采用UTF-8(无BOM)，并不能自动识别文档的编码，需要修改可以在右下角选择。但有一不方便的地方是即使修改过一次打开的编码，下次打开时依然会默认UTF-8打开，每次只能手动修改。</br>
同理，VS Code默认Tab键为4个(半角)空格，有一些编辑器的默认Tab为2个空格。可以选择使用制表符作为Tab键输入以及更改Tab长度。同时也可以将文档中现有的空格和制表符相互转换，对缩进格式十分严格的在下来说这是十分实用的功能。</br>
作为最初在Windows上的编辑器，VS Code的默认换行符自然是Windows/DOS的CRLF(回车换行)。自然，除非使用系统自带的Notepad打开文件或者是远古时期的编译器，大部分现代的文本编辑器都能正确识别CRLF和LF的文档，其实不用过于纠结使用何种换行符。

设置

VS Code使用JSON进行设置，熟悉JSON语法可以很快上手。当然，其实没有接触过JSON也能很容易地进行设置，因为VS Code已经写好了详细的中文注释，其实需要修改的设置也并没有那么多，大部分保持默认即可。其中，字体方面在下比较推荐Consolas，VS Code支持设置多个字体，当前一字体没有某一字符时会自动Fallback至下一字体，所以可以如下设置Consolas + 思源黑体。当然对「Courier New」「Lucida Console」「Source Code Pro / Source Han Code JP」有特别喜好的也可以设置。

"editor.fontFamily": "Consolas, 思源黑体 Regular"

等宽字体大多没有中文字符集，对于不支持多个字体的编辑器，比较好的选择是Windows注册表的fontlink。或者是「Microsoft Yahei Mono」和「Inziu Iosevka」字体。Consolas的优势在于意大利体，斜体下别有韵味，Microsoft Yahei Mono虽然是将Consolas和微软雅黑拼合，但是并没有Consolas的意大利体；而Inziu Iosevka则是仅有的中英文混排可以严格对齐的字体。</br>
安装插件后，附加的设置选项会添加在默认设置的下面(当然可能就没有注释了)。按照插件页面的说明也能方便地进行设置。比如LaTeX Workshop建立XeLaTeX的输出设置如下。

"latex-workshop.latex.toolchain": [
       {
           "command": "xelatex",
           "args": [
               "-synctex=1",
               "-interaction=nonstopmode",
               "-file-line-error",
               "%DOC%"
           ]
       }
   ]

另外，设置一个顺眼的颜色主题和图标主题是十分重要的。在扩展中可以搜索颜色主题和图标主题，比如著名的Monokai样式。Monokai相比默认的Visual Studio样式，对各种关键词的高亮要丰富得多，同时深色主题看着要比亮色主题舒服很多。GitHub样式也是一个不错的主题。而图标主题Material样式风格统一，覆盖的文件类型也比较全面。值得一提的是Visual Basic Script(.vbs)格式几乎没有被任何一个图标主题包含，毕竟PowerShell已经能完全取代任何的Windows Shell了吧。

快捷键

众所周知，快捷键是一个文本编辑器是否高端的标识。VS Code可以通过扩展支持Vim, Sublime等编辑器的快捷键。</br>
话虽如此，像在下这么懒的人是不会去记Vim的快捷键的。VS Code默认基本使用的快捷键和大多数微软软件相同，即

• Ctrl + C | Ctrl + C | Ctrl + V ····· 复制 | 剪切 | 粘贴
• Ctrl + Z | Ctrl + Y ············· 撤销 | 恢复
• Ctrl + F | Ctrl + H ············· 搜索 | 替换
• Ctrl + W ···················· 关闭标签页

等。而生成调试的快捷键则与Visual Studio一直，即

• F5 ········· 调试启动
• Ctrl + F5 ···· 非调试启动
• F9 ········· 设置断点
• F10 ········ 单步跳过
• F11 ········ 单步执行

等。VS Code专属的快捷键有可打印的清单，多加使用记忆并不困难。所有命令可以通过Ctrl + Shift + P唤出，包括扩展插件的命令。而设置相关则有两步快捷键，先按下Ctrl + K再按下其他Ctrl组合键完成。

Git & GitHub

首先需要安装Git程序。然后就可以在扩展中安装各种各样的Git插件了。如Git History, Git Blame, Git Lens等等。</br>
要Push至GitHub，自然要先与远程Repository建立关联，建议还是使用Git GUI完成比较方便，自然技术过硬可以直接使用VS Code的控制台完成。之后就能在源代码管理界面完成Commit, Pull, Push, Merge等等操作了。装有插件自然还能可视化Git历史，进一步方便管理。

Debug

在打开文件夹状态下，就可以添加Debug配置。配置合理起见，为每个工程添加独立Debug配置是比较好的。但也可以在一个文件夹下放置所有的Debug配置。</br>
点击添加配置就能建立新的launch.json，有技术的话自然可以自己来写debug配置，到网上找一下别人写好的配置也是没有问题的。下面会在C/C++插件中详细介绍如何配置GDB。

扩展

C/C++

以MinGW的GCC编译器为例。安装后需要手动在系统环境变量PATH中添加MinGW的bin路径，由于PowerShell对环境变量更新问题，最好重启一次。然后就能在VS Code中添加g++生成任务和Debug配置了。</br>
首先在菜单中配置新任务，任务其实就是运行一个程序或在Shell执行指令，同样是JSON格式。示例g++生成任务如下，g++/gcc的参数自行参考gcc文档。当然也可以使用Clang，相比之下gcc的编译错误信息实在是麻烦。Windows平台完整的Visual Studio 2017自然是无敌的~

"version": "2.0.0",
"tasks": [
  {
      "taskName": "g++",
      "command": "g++",       //执行的编译器文件g++.exe
      "args": [           //g++的编译参数
           "-g", 
           "${file}", 
           "-o",
           "${fileDirname}/${fileBasenameNoExtension}.exe",
           "-Og",
           "-static-libgcc", 
           "-static-libstdc++", 
           "-Wall"
       ],
       "type": "shell",       //在Shell中执行，默认作为进程执行
       "group": {     //执行组为生成组，且为默认
           "kind": "build",
           "isDefault": true
       },
       "presentation": {  //在输出面板显示
           "echo": true,
           "reveal": "always",
            "focus": false,
            "panel": "shared"
       },
       "problemMatcher": {    //错误信息显示
           "owner": "cpp",
           "fileLocation": ["relative", "${worksapceRoot}"],
           "pattern": {
               "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$", //正则匹配
               "file": 1,
               "line": 2,
               "column": 3,
               "severity": 4,
               "message": 5
           }
       }
   }
]

生成exe后，就能执行gdb来进行debug了。配置如下：

{
   "name": "C++ Launch (GDB)",
   "type": "cppdbg",
   "request": "launch",
   "targetArchitecture": "x86",
   "program": "${fileDirname}/${fileBasenameNoExtension}.exe",    //被debug程序
   "miDebuggerPath": "C:/MinGW/bin/gdb.exe",  //gdb路径
   "args": [                      //给gdb的参数
   ],
   "stopAtEntry": false,
   "cwd": "${workspaceRoot}",     //被debug程序的工作路径
   "externalConsole": true,       //调用外部控制台
   "preLaunchTask": "g++"         //先执行g++任务生成exe
},

LaTeX Workshop

首先需要安装TeX发行版，推荐TeX Live，CTeX目前已经很久没有更新了。对于TeX的各种配置，如pdfLaTeX, BibLaTeX, XeLaTeX以及CJK中文字体等的问题属于TeX知识，在这里就不说了。对于基本使用，只要选择一个满足自己需求的包即可，使用XeLaTeX可以参考上文中的设置。在TeX发行版中安装了chktex还可以打开语法检查功能。

Markdown Preview Enhanced

相较于其他Markdown预览插件，Markdown Preview Enhanced(MPE)拥有对MathJax/KeTeX的支持，能够在预览中显示LaTeX公式(虽然没有真正的LaTeX那么美观)。可以自定义CSS样式，使输出的Markdown文件更加个性化。并且自带了输出为HTML, pdf等多种格式的功能。当然输出pdf等格式需要安装PhantomJS或PrinceXML等软件，装有Acrobat或者其他pdf创建软件也可以从HTML创建pdf文档。</br>
不太建议安装markdownlint插件检查语法，因为各个Markdown插件间的语法解释都略有不同。比如对于换行，大多数Markdown插件都需要手动在段尾添加</br>才能换行，但MPE就能自动换行。
$\mathrm{\LaTeX}$示例:
$$
\oint_c \vec{H} \cdot \mathrm{d} \vec{l} = \int_s \left( \vec{J_c} + \vec{J_v} +\frac{\partial\vec{D}} {\partial t} \right) \cdot \mathrm{d} \vec{s}
$$

$$
\displaystyle\oint_c \vec{E} \cdot \mathrm{d} \vec{l} =
-\int_s \frac{\partial\vec{B}}{\partial t} \cdot \vec{s}
$$

$$
\oint_s \vec{D} \cdot \mathrm{d} \vec{s} =
\int_V \rho \mathrm{d} V
$$

$$
\oint_s \vec{B} \cdot \mathrm{d} \vec{s} = 0
$$

$$
\nabla \times \vec{H} = \vec{J} + \frac{\partial\vec{D}}{\partial t}
$$

$$
\nabla \times \vec{E} = -\frac{\partial\vec{B}}{\partial t}
$$

$$
\nabla \cdot \vec{D} = \rho
$$

$$
\nabla \cdot \vec{B} = 0
$$

Auto-Open Markdown Preview

相比MPE更为轻便，自带的样式也比较美观，不需要自己来写CSS。自动弹出挺方便，但有的时候不想预览的时候也挺烦的。在语法上和MPE有部分区别，建议采用最为稳妥的语法规则，避免问题。

#待续 To be Continued