vscode clang-format配置（不生效问题）

最新推荐文章于 2025-07-04 13:40:37 发布

原创最新推荐文章于 2025-07-04 13:40:37 发布 · 5.5k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#vscode #c++

开发环境同时被 2 个专栏收录

1 篇文章

订阅专栏

vscode

1 篇文章

订阅专栏

本文介绍了如何在VSCode中配置clang-format，包括安装插件、clang-format、新建格式文件及设置，以及遇到配置后不生效的解决办法，如手动选择默认格式化工具。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

打开Settings设置

菜单栏File -> Preferences -> Setting (Windows)
Ctrl+Shift+P 搜索Settings打开

Settings分类

User: 全局设置（安装时默认文件目录里）
Remote: 远端设置（ssh用户的.vscode-server/data/Machine/settings.json）
Workspace: 当前项目设置（优先生效，一般在项目根目录.vscode/settings.json）

clang-format配置

1.安装插件

2.安装clang-format

3.新建格式文件

新建配置文件如.clang-format填充自定义格式，如

# 基础风格
BaseOnStyle: Google
# 操作符对齐
AlignOperands: Align
# 注释对其
AllowTrailingComments: true
# other...

4.配置设置

配置参考模板

settings.json
{
	"files.autoSave": "afterDelay",
	"editor.formatOnSave": true,
	"clang-format.assumeFilename": "${workspaceFolder}/.clang-format",
	"clang-format.executable": "/bin/clang-format"
}

clang-format.executable
如果安装了clang-format添加环境变量后，可以直接用默认的不配置该字段

注意事项

安装配置之后，发现保存没有生效？
可能是没有设置默认format方式，手动执行一次format：Ctrl+Shift+P搜索format，会提示选择默认格式化工具，选择clang-format即可（会在User的settings.json里添加类似配置）

#...
"[cpp]": {
	"editor.defaultFormatter": "xaver.clang-format"
}