本文使用“署名-非商业性使用-相同方式共享 4.0 国际(CC BY-NC-SA 4.0)”进行许可。
商业转载请联系站长获得授权,非商业转载请注明本文出处及文章链接。 如果您再混合、转换或者基于本作品进行创作,您必须基于相同的协议分发您贡献的作品。
更新:由于在 2023/09/24 将这个配置作为主力配置,所以大更了一波,相当于重写了,所以修改了发布日期重新发一遍。本文原写于 2023/03/09。
因为一些作死操作,把我之前用的 Ubuntu 搞崩了,借此机会把 wsl 的发行版改成了 Arch,vscode 也打算使用 llvm 全家桶。
安装 Arch 非常方便,How to Setup | ArchWSL official documentation (wsldl-pg.github.io) 按着这个链接里的方法,10 分钟内就能搞定。
更新:换了 macOS 作为主力系统,当然得用 llvm 全家桶()
本文主要应用场景是单文件的编译,主要用来刷算法题之类。如果使用 CMake 等工具,则本文中的一部分配置并不一定兼容。
主要分为两步操作,使用 clang/lldb 编译和调试,以及使用 clangd 进行补全和检查,这两者应该是互相独立的,可以只使用其中一个,但是找到的大多数教程好像都是两个混在一起搞得。
本文的配置不使用 C/C++ 插件 和 Code Runner 插件!!请禁用或者卸载它们。由于 VSCode 和 C/C++ 插件的一些 bug,我选择绕开它们,使用 CodeLLDB 和 Clangd 来替代。
我的环境:
Windows11, Arch Linux on WSL2macOS Ventura 13.5 on Apple Silicon 我觉得应该能行的环境: 任何 M 系列芯片的 Mac,稍微修改可以兼容大部分设备。
确保 clang++
已经正确安装(通过 clang++ -v
可以验证)
xcode-select --install
可以安装好本文用到的所有包vscode 已启用 CodeLLDB 插件(报错无法下载可以先按报错给的 url 用浏览器下载,然后手动安装)
卸载微软提供的 C/C++ 插件!!!也不要使用 Code Runner 插件。
tasks.json,放入.vscode 文件夹中
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "C/C++: clang++ build active file",
"command": "/usr/bin/clang++", // `which clang++` may help you find this path
"args": [
"--std=c++17",
"-fcolor-diagnostics",
"-fansi-escape-codes",
"-g",
"${file}",
"-o",
"${workspaceFolder}/.build/${fileBasenameNoExtension}"
"-fstandalone-debug", // to enable viewing std::string etc. when using lldb on Windows or Linux
],
"options": {
"cwd": "${fileDirname}"
},
"group": {
"kind": "build",
"isDefault": true
},
"detail": "Task generated by Debugger."
}
]
}
我的习惯是把所有的可执行文件放到
./build/
文件夹下,如果不这么做的话,改变 3、4 步中的文件路径,以及忽略第五步
launch.json,放入.vscode 文件夹中
{
"version": "0.2.0",
"configurations": [
{
"name": "C/C++: clang++ build and debug active file customize",
"type": "lldb",
"request": "launch",
"program": "${workspaceFolder}/.build/${fileBasenameNoExtension}",
"args": [],
"cwd": "${workspaceFolder}",
"preLaunchTask": "C/C++: clang++ build active file"
}
]
}
在文件夹里新建一个 .build 文件夹( macOS / Linux 必做)
按 F5,就可以编译调试了
这样的配置下,右上角不会有运行的那个小按钮。由于未知问题,这个又 C/C++ 插件提供的按钮不会同步 tasks.json 和 launch.json 中的配置,所以放弃使用了那个插件。
确保已安装 clangd(应该和 clang++ 在一个包里的,通过 clangd --version
检查)
安装 VScode 插件 clangd
在工作区根目录下新建一个 compile_flags.txt
,这是用来为 clangd 指定参数的,比如使用的标准或是标准库路径之类。内容就是编译选项,一行一个。这里只写了一个标准作为例子
--std=c++17
一般来说 clangd 的参数是由 compile_commands.json 指定,由 CMake 等构建工具自动生成。但是由于在我的需求中对每一个文件都是相同的编译参数,所以可以手写 compile_flags.txt 统一管理。 具体查看 JSON Compilation Database Format Specification
我的习惯是直接放在 ~
下(如果你的代码都放在你的~和其子文件夹里的话)
生成的话,官方文档的那个网页实在是太丑了,我直接选择去 CLion 里配好,然后导出为 .clang-format,既可视化又方便
贴一下我的.clang-format
# Generated from CLion C/C++ Code Style settings
BasedOnStyle: LLVM
AccessModifierOffset: -4
AlignAfterOpenBracket: Align
AlignConsecutiveAssignments: None
AlignOperands: Align
AllowAllArgumentsOnNextLine: false
AllowAllConstructorInitializersOnNextLine: false
AllowAllParametersOfDeclarationOnNextLine: false
AllowShortBlocksOnASingleLine: Always
AllowShortCaseLabelsOnASingleLine: false
AllowShortFunctionsOnASingleLine: All
AllowShortIfStatementsOnASingleLine: Always
AllowShortLambdasOnASingleLine: All
AllowShortLoopsOnASingleLine: true
AlwaysBreakAfterReturnType: None
AlwaysBreakTemplateDeclarations: Yes
BreakBeforeBraces: Custom
BraceWrapping:
AfterCaseLabel: false
AfterClass: false
AfterControlStatement: Never
AfterEnum: false
AfterFunction: false
AfterNamespace: false
AfterUnion: false
BeforeCatch: false
BeforeElse: false
IndentBraces: false
SplitEmptyFunction: false
SplitEmptyRecord: true
BreakBeforeBinaryOperators: None
BreakBeforeTernaryOperators: true
BreakConstructorInitializers: BeforeColon
BreakInheritanceList: BeforeColon
ColumnLimit: 0
CompactNamespaces: false
ContinuationIndentWidth: 8
IndentCaseLabels: true
IndentPPDirectives: None
IndentWidth: 4
KeepEmptyLinesAtTheStartOfBlocks: true
MaxEmptyLinesToKeep: 2
NamespaceIndentation: All
ObjCSpaceAfterProperty: false
ObjCSpaceBeforeProtocolList: true
PointerAlignment: Right
ReflowComments: false
SpaceAfterCStyleCast: true
SpaceAfterLogicalNot: false
SpaceAfterTemplateKeyword: false
SpaceBeforeAssignmentOperators: true
SpaceBeforeCpp11BracedList: false
SpaceBeforeCtorInitializerColon: true
SpaceBeforeInheritanceColon: true
SpaceBeforeParens: ControlStatements
SpaceBeforeRangeBasedForLoopColon: false
SpaceInEmptyParentheses: false
SpacesBeforeTrailingComments: 0
SpacesInAngles: false
SpacesInCStyleCastParentheses: false
SpacesInContainerLiterals: false
SpacesInParentheses: false
SpacesInSquareBrackets: false
TabWidth: 4
UseTab: Never
enternalConsole
为 false 的时候并不会像在 Windows 中一样出现一个新的集成终端用来输入,导致没有地方输入从而无法调试。launch.json
中 type 为 “cppdbg” 时。这是 VSCode 的 bug,微软文档提供了一种解决方案,但是实测没效果()enternalConsole
设为 true,如果接受使用外部终端进行调试的话;CodeLLDB
插件提供的调试选项。也就是按照本文进行操作。吐槽:VSCode 的 bug 还真不少,在 Windows 上外部终端用不了,Mac 上却又只能用外部终端()
127.0.0.1:端口
),本文使用“署名-非商业性使用-相同方式共享 4.0 国际(CC BY-NC-SA 4.0)”进行许可。
商业转载请联系站长获得授权,非商业转载请注明本文出处及文章链接。 如果您再混合、转换或者基于本作品进行创作,您必须基于相同的协议分发您贡献的作品。