LOADING

加载过慢请开启缓存 浏览器默认开启

VSCode 配置教程

2023/8/28 教程 VSCode

面向 OIer 的 VSCode 配置教程。

1. 安装环境

1.0. 安装 Motrix(可选)

https://motrix.app

安装后就可以用 Motrix 快速下载了。

1.1. 安装 VSCode

https://code.visualstudio.com

最后一个支持 Windows 7 的版本:https://code.visualstudio.com/updates/v1_70

1.2. 安装 MinGW-W64

https://github.com/niXman/mingw-builds-binaries

点击右边的 Latest 可以找到最新版本。

下载文件名形如 x86_64-*-release-posix-seh-ucrt-*.7z 的文件。

解压到合适的位置然后将其中的 mingw64/bin 添加到环境变量。

1.3. 安装 Git Bash

https://git-scm.com/download/win

安装 Git Bash 是因为 Windows CMD 太难用了。

1.4. 安装字体

2. VSCode

2.1. 安装扩展

打开 VSCode 然后安装以下扩展:

  1. C++ Extension Pack
  2. Code Runner
  3. Competitive Programming Helper (cph)
  4. One Dark Pro
  5. vscode-icons
  6. Fluent Icons
  7. Error Lens
  8. Prettier
  9. Markdown All in One
  10. vscode-pdf
  11. Chinese (Simplified) Language Pack for Visual Studio Code

有些教程说要配置 launch.json tasks.json 才能运行,但是这样太麻烦了。

我们安装 Code Runner 扩展后 Ctrl+Alt+N 就可以了,或者你可以直接用 cph。

2.2. 创建文件夹

在一个合适的位置创建一个合适的文件夹用于存储你所有的 C++ 文件。

然后还需要创建一些配置文件,创建完成后目录结构应为如下:

cpp
|---.vscode
|   |---settings.json
|---.clang-format

实际上可以不创建而是使用全局的 settings.json

直接按 Ctrl+Shift+P 然后输入 >workbench.action.openSettingsJson 就可以打开。

2.3. 配置文件

配置文件的内容:

// settings.json
{
    "[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
    "[jsonc]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
    "[markdown]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
    "[yaml]": { "editor.tabSize": 4 },
    "C_Cpp.autoAddFileAssociations": false,
    "code-runner.executorMap": {
        "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -std=c++17 -Wall -Wextra -O2 -Wl,--stack=2147483647 -march=native && './$fileNameWithoutExt.exe'"
    },
    "code-runner.fileDirectoryAsCwd": true,
    "code-runner.ignoreSelection": true,
    "code-runner.runInTerminal": true,
    "cph.general.autoShowJudge": false,
    "cph.language.cpp.Args": "-std=c++17 -O2 -Wl,--stack=2147483647 -march=native",
    "cph.language.cpp.Command": "g++",
    "editor.bracketPairColorization.enabled": false,
    "editor.cursorBlinking": "smooth",
    "editor.cursorSmoothCaretAnimation": "on",
    "editor.cursorStyle": "block",
    "editor.fontFamily": "'Fira Code', 'Noto Sans CJK SC'",
    "editor.fontLigatures": "'cv01' on, 'cv02' on, 'ss09' on, 'zero' on",
    "editor.minimap.renderCharacters": false,
    "editor.minimap.scale": 2,
    "editor.rulers": [100],
    "editor.stickyScroll.enabled": false,
    "editor.wordWrap": "on",
    "explorer.autoReveal": false,
    "explorer.confirmDelete": false,
    "explorer.confirmDragAndDrop": false,
    "explorer.confirmPasteNative": false,
    "files.associations": { "*.{in,out,ans}": "plaintext", ".clang*": "yaml" },
    "files.autoGuessEncoding": true,
    "markdown.preview.fontFamily": "'Noto Sans CJK SC'",
    "prettier.printWidth": 100,
    "prettier.tabWidth": 4,
    "search.followSymlinks": false,
    "terminal.integrated.defaultProfile.windows": "Git Bash",
    "terminal.integrated.enableMultiLinePasteWarning": "never",
    "terminal.integrated.fontFamily": "'Fira Code', 'Noto Sans CJK SC'",
    "terminal.integrated.letterSpacing": 1,
    "workbench.colorTheme": "One Dark Pro Mix",
    "workbench.editor.pinnedTabSizing": "compact",
    "workbench.iconTheme": "vscode-icons",
    "workbench.productIconTheme": "fluent-icons",
    "workbench.tree.enableStickyScroll": false,
    "workbench.tree.indent": 20
}
# .clang-format
BasedOnStyle: LLVM
AllowShortBlocksOnASingleLine: Always
AllowShortCaseLabelsOnASingleLine: true
AllowShortEnumsOnASingleLine: true
AllowShortFunctionsOnASingleLine: All
AllowShortIfStatementsOnASingleLine: AllIfsAndElse
AllowShortLambdasOnASingleLine: All
AllowShortLoopsOnASingleLine: true
BreakBeforeConceptDeclarations: Allowed
ColumnLimit: 100
IndentWidth: 4
RequiresClausePosition: SingleLine

这个配置的编译器用的是 GCC,如果你想用 Clang 可以自行修改。

c_cpp_properties.json 应该会自动配置。

3. clangd(可选)

3.1. 安装 LLVM

https://github.com/llvm/llvm-project

点击右边的 Latest 可以找到最新版本。

下载文件名形如 LLVM-*-win64.exe 的文件,然后安装即可。

注意要选择 Add LLVM to the system PATH for current user。

3.2. 安装扩展

安装 clangd 扩展即可。

3.3. 配置文件

配置 clangd 后的目录结构应为如下:

cpp
|---.vscode
|   |---settings.json
|---.clang-format
|---.clangd

需要添加的配置文件内容:

// settings.json
{
    "C_Cpp.intelliSenseEngine": "disabled",
    "clangd.fallbackFlags": ["--target=x86_64-windows-gnu"]
}
# .clangd
CompileFlags:
    Add:
        - -std=c++17
        - -Wall
        - -Wextra
    Compiler: clang++
Index:
    Background: Skip
    StandardLibrary: false
InlayHints:
    Enabled: false
Diagnostics:
    ClangTidy:
        Add: llvm-*
    MissingIncludes: Strict
SemanticTokens:
    DisabledKinds: Operator

另外还有一个问题就是 clangd 可能会被大结构体数组卡到很慢,例如:

std::pair<int, int> hack_clangd[1 << 20];

如果出现这种情况,你可以 Ctrl+Shift+P 然后输入 >clangd.restart 重启 clangd。

VSCode,启动!