配置VSCode的Clangd语言服务支持STM32开发

发表于 2025-03-17 更新于 2025-03-18 阅读次数：本文字数： 3.6k

众所周知STM32开发一般使用Keil或者CubeIDE来管理工程和编译，但是这俩玩意的编辑器都不太现代化，用起来不太爽，所以也有很多人用VSCode来编写代码，只使用IDE来进行编译和调试（当然也有使用VSCode+全套开源工具链打包进行编写+编译+调试的，但是在win下实现起来尤为的不方便以前尝试过这里先按下不表）

然而vsc虽然很好用，但是他默认的C/C++插件功能就很难说是强大了，自动补全和语法检查经常傻傻的。一直也就这么凑合着用下来，今天一不小心给vsc的补全又玩炸了，调配置的时候突然想起这事，于是去搜了一下，说vsc其实是可以支持强大的clangd语言服务的…

谁想到这就是坠入大坑的开始…

懒得多介绍了，网上一堆，简单说clangd应该是通用的最强大的C/C++语言服务（有没有之一？）

性能和特性都比vsc默认的微软工具强很多

安装clangd其实很简单，在拓展商店里直接装就行了，他还会提醒你本地没有语言服务，选择自动安装就可以给你配好了，没啥难度

然后按照网上的教程配置clangd的特性

打开vsc的配置json

"C_Cpp.errorSquiggles": "disabled",
"C_Cpp.intelliSenseEngineFallback": "Disabled",
"C_Cpp.intelliSenseEngine": "disabled",
"C_Cpp.autocomplete": "disabled", // So you don't get autocomplete from both extensions.

这些代码用来禁用原来的拓展的语言服务，防止冲突。

clangd路径已经被自动配置好了

"clangd.arguments": [
// 让 Clangd 生成更详细的日志
"--log=verbose",
// 输出的 JSON 文件更美观
"--pretty",
// 全局补全(输入时弹出的建议将会提供 CMakeLists.txt 里配置的所有文件中可能的符号，会自动补充头文件)
"--all-scopes-completion",
// 建议风格：打包(重载函数只会给出一个建议）
// 相反可以设置为detailed
"--completion-style=bundled",
// 跨文件重命名变量
"--cross-file-rename",
// 允许补充头文件
"--header-insertion=iwyu",
// 输入建议中，已包含头文件的项与还未包含头文件的项会以圆点加以区分
"--header-insertion-decorators",
// 在后台自动分析文件(基于 complie_commands，我们用CMake生成)
"--background-index",
// 启用 Clang-Tidy 以提供「静态检查」
"--clang-tidy",
// Clang-Tidy 静态检查的参数，指出按照哪些规则进行静态检查，详情见「与按照官方文档配置好的 VSCode 相比拥有的优势」
// 参数后部分的*表示通配符
// 在参数前加入-，如-modernize-use-trailing-return-type，将会禁用某一规则
"--clang-tidy-checks=cppcoreguidelines-*,performance-*,bugprone-*,portability-*,modernize-*,google-*",
// 默认格式化风格: 谷歌开源项目代码指南
// "--fallback-style=file",
// 同时开启的任务数量
"-j=2",
// pch优化的位置(memory 或 disk，选择memory会增加内存开销，但会提升性能) 推荐在板子上使用disk
"--pch-storage=memory",
// 启用这项时，补全函数时，将会给参数提供占位符，键入后按 Tab 可以切换到下一占位符，乃至函数末
// 我选择禁用
"--function-arg-placeholders=false",
// compelie_commands.json 文件的目录位置(相对于工作区，由于 CMake 生成的该文件默认在 build 文件夹中，故设置为 build)
"--compile-commands-dir=build"
]