- 1. 插件的用法
- 2. C++开发常用的快捷键
- 3. 参考文档
1. 插件的用法
1.1. C/C++
1.1.1. 插件介绍
在VSCode下进行C/C++开发,C/C++
插件是最重要、功能最强大、也是最复杂的一个插件。我们从C/C++
的插件配置也能看出端倪:整个插件有158项配置,包含7大功能模块:
IntelliSense
: 代码智能提示、补全、跳转等功能,集成了C++ Intellisense
插件的几乎所有功能。Formatting
: 代码格式化器,可对代码进行自动格式化。Code Documentation
: 通过代码(注释)生成文档,定义注释的样式,集成Doxygen等工具。Code Analysis
: 代码分析器,对代码的错误、风格等进行检查,集成了Clang-Tidy
。Debugging
: Debug调试器。Resource Management
: 资源管理器。Miscellaneous
: 其他杂项配置。
进行C/C++开发,C/C++
是必装的一个插件,因为没有这个插件,你跟在记事本里写代码没有太大区别。
1.1.2. 插件配置
虽然C/C++
这个插件功能很多很复杂,但是我们也并不需要把158项配置全都了解完。因为大部分配置我们直接用默认的就可以了,并不需要逐个去了解他,默认配置即是最佳配置。我们只需要了解一小部分常用配置即可。
settings.json:
1.2. Clang-Format
- 下载LLVM
点击 llvm-project/releases 进入LLVM项目的二进制下载页面,下载最新版本的Windows安装包。
- 安装LLVM
将下载后的安装包clang+llvm-18.1.8-x86_64-pc-windows-msvc.tar.xz
解压后拷贝到自己的软件安装目录下(如:C:\software\clang-llvm-18.1.8
),bin
目录下会有个 clang-format.exe
,这个就是我们需要的代码格式化器。
- 配置码格式化器
打开Clang-Format插件的配置页面:
vscode -> Settings -> Extensions -> Clang-Format configuration
方式一:
将clang-format.exe
的绝对路径设置到Executable
。
方式二:
将C:\software\clang-llvm-18.1.8\bin
目录添加到系统环境变量的Path
中,VSCode配置页的Executable
填写clang-format
。
如果不配置 clang-format.exe 路径,格式化代码就会报错如下:
- 格式化代码的快捷键
格式化部分代码: 选中部分代码,ctrl + k , ctrl + f
格式化所有代码: shift + alt + f。
格式化整个代码源文件: 编辑区域右键 -> Format Document。
- 设置代码风格样式
打开Clang-Format插件的配置页面:vscode -> Settings -> Extensions -> Clang-Format configuration
Fallback Style:选择你喜欢的风格样式,可以使用以下这些值,这些都是最受欢迎的C++代码风格样式:
LLVM, Google, Chromium, Mozilla, WebKit。
- 自定义代码样式
如果以上这些代码风格的样式都不能满足你的需求,可以自定义代码风格样式,也可以基于某种特定的代码风格做一些符合自己习惯的样式调整。
在项目的根目录下创建一个.clang-format
文件,并在文件中写入自定义的代码风格样式,具体格式定义的使用规则可以参考 Clang-Format Style Options。
以下是个人的.clang-format
配置,可以作为Demo提供参考:
1.3. cpp-check-lint
cpp-check-lint基于cppcheck
和cpplint
的C++代码检查工具,他将cppcheck
、cpplint
和VSCode
完美的集成在一起。对cppcheck
和cpplint
有依赖,其中cppcheck
需要自己另外手动安装,并将可执行文件的路径配置到插件的cpp-check-lint.cppcheck.--executable
。
1.3.1. cpplint
cpplint是一个用于检查C++代码规范的工具,它可以帮助我们自动化地检查代码,发现潜在的编码问题,确保代码风格的一致性和规范性,提高代码质量。cpplint
的代码检查会遵循 Google C++ Style Guide。cpplint
工具本身是有Python实现的,可以通过pip install
来安装。
cpplint
侧重于C++代码规范和风格的检查。
1.3.2. cppcheck
cppcheck是一个 C/C++ 静态代码分析工具,检测编译器通常无法检测到的错误类型,目标是没有误报。
cpplint
侧重于C++代码的错误、潜在安全问题、潜在性能问题的检查。
检查范围包括:
1.3.3. 插件的使用
- 下载并安装Cppcheck(Windows通过安装包安装的话,安装完后要设置Path环境变量)。
- 打开命令行终端,执行
cppcheck --version
检查是否安装正常,有正常输出版本号说明安装成功。 - 重启VSCode.
- 打开配置页(vscode -> Settings -> Extensions -> cpp-check-lint)完成相应的配置:
关键配置说明如下:
1.4. C/C++ Advanced Lint
1.4.1. 插件介绍
C/C++ Advanced Lint
是C/C++静态代码分析工具,支持:1. 自动识别可用的静态代码分析工具,2. 代码编写过程中执行检测。与cpp-check-lint
是同类型的插件,最大的区别是支持的代码分析工具的钟磊和数量不同。
cpp-check-lint
只支持:
- CppCheck
- CppLint
C/C++ Advanced Lint
支持:
- CppCheck
- Clang
- FlawFinder
- PC-lint Plus
- Flexelint or PC-lint
- lizard
C/C++ Advanced Lint
要正常使用,至少需要安装一种上面的代码分析工具(可以同时安装和启用多个分析工具)。
1.4.2. 插件配置
关键配置:
代码分析工具的配置:
Cppcheck
的配置可以参考“ 5.2.3. 插件的使用”的相关内容。- 其他代码分析工具的配置,大家可以自己阅读对应的官方文档。
- 只需要配置已安装并启用的代码分析工具。
1.5. Bracket Pair Colorizer
1.5.1. 插件介绍
插件功能:成对的括号标记成不同的颜色,提高代码的可读性。
插件说明:该插件已废弃,因为最新版本(我的1.91.1版本已经内置了)的VSCode已经内置了该功能。
1.5.2. 功能配置
既然VSCode已经内置了该功能,我们将不在需要安装这个插件,直接在VSCode的设置中配置该功能即可。
- 打开配置页面:vscode -> Settings
- 在搜索框种输入
@id:editor.bracketPairColorization.enabled @id:editor.guides.bracketPairs
。 Editor › Guides: Bracket Pairs
的三个可选参数,含义分别如下:false
: 禁用括号对引导线
。true
: 启用括号对引导线
。active
: 只对当前光标所在的括号对启用括号对引导线
。
1.6. Code Runner
1.6.1. 插件介绍
Code Runner是一款VSCode的插件,它可以让你在VSCode中运行C、C++、Java、Python、JavaScript、PHP、Go、Swift、Perl、Ruby、R等语言的代码。
通过这个插件可以快速的编译、运行C++代码,在编写和调试一些Demo代码时非常方便。(在编译大型项目代码时还是建议用CMake、QT、Visual Studio等工具)。
1.6.2. 插件配置
settings.json:
1.6.3. 插件使用
方法一:在要执行的.cpp文件右键 -> Run Code
方法二:在VSCode的命令面板中输入:Code Runner: Run Code
,然后选择Run Code
按回车
方法三:快捷键:Ctrl + Alt + N
1.7. TODO Highlight
1.7.1. 插件介绍
TODO Highlight是一款VSCode的插件,它可以高亮显示代码中存在的TODO
和FIXME
等注释,方便开发者快速定位代码中需要解决的任务。
1.7.2. 添加高亮关键字
- 进入设置页面:
vscode -> Settings -> Extensions -> TODO Highlight
。 - 在
TODOhighlight:Keywords
配置项点击Edit in settings.json
。 - 在
"todohighlight.keywords"
中增加需要定义的关键词。
插件默认只配置了两个关键字:TODO:
和 FIXME:
,注意后面需要跟:
才能显示高亮。定义如下:
我的需求是:
- 关键不加
:
也要能高亮。 - 关键字要同时支持大小写。
修改后的配置如下:
2. C++开发常用的快捷键
Windows/Linux | macOS | 功能描述 |
---|---|---|
Alt + O | Option + O | 头文件(.h)与源文件(.cpp)之间切换 |
F12 | Fn + F12 | 快速跳转到变量或函数的定义 |
Shift + F12 | Shift + Fn + F12 | 查看所有引用,如:变量或函数的定义和所有被调用的地方 |
Alt + F12 | Cmd + Shift + F10 | Peek(窥视)定义: 在不离开当前代码上下文的情况下查看符号的定义 |
3. 参考文档
https://clang.llvm.org/docs/ClangFormatStyleOptions.html
https://dev.to/dhanu0510/how-to-configure-c-code-formatting-in-visual-studio-code-4d5m