VSCode下C++代码格式化未按配置添加/保留括号前后空格如何解决

核心原因说明 #

你碰到的“开了设置不生效、还被自动删除手动输入的括号空格”，本质是两个问题叠加导致的：

1. 设置面板里的「括号前后添加空格」开关，只适配C/C++扩展旧版本的内置格式化器——也就是当C_Cpp.formatting设为Default时才有效。只要切到现在C++开发通用的clang-format后端，这个UI开关的控制链路直接断开，哪怕你在settings.json里看到这个配置是true，规则也根本传不到格式化引擎里
2. clang-format的默认内置风格（比如Google风格）默认会强制清理括号前后的冗余空格，所以会表现为“不自动补空格、还删手动加的空格”

具体配置调整步骤 #

1. 先确认格式化的绑定对象没出错 #

按Ctrl+,打开设置面板，搜索两个配置项核对：

• 搜索C_Cpp: Formatting，确保值是clangFormat（这是目前最稳定的C++格式化选项）
• 搜索Editor: Default Formatter，确保C文件的默认格式化器是微软的C/C扩展（ms-vscode.cpptools），避免你安装的CMake类扩展误接管格式化权限

2. 直接给clang-format写明确的空格规则 #

既然UI开关失效，就直接在全局settings.json里内嵌clang-format规则，不用单独创建项目级的.clang-format文件，配置如下：

{
    "C_Cpp.clang_format_style": "{
        BasedOnStyle: LLVM,
        SpaceBeforeParens: ControlStatements,
        SpaceAfterCStyleCast: true,
        SpaceInEmptyParentheses: false
    }"
}

参数说明：

• SpaceBeforeParens: ControlStatements：这就是需要的核心规则——会在if/for/while这类控制语句的开括号前自动补空格，同时不会强制删掉你手动在括号前后输入的合法空格
• 如果需要连函数名和括号之间的空格也要保留（比如写void test ()而不是void test()），把这个参数值改成Always就行
• 要是习惯Visual Studio的原生格式化手感，直接把BasedOnStyle的值换成Visual Studio就可以

3. 排查项目级的规则覆盖 #

• 检查项目根目录有没有独立的.clang-format文件，如果里面写了SpaceBeforeParens: Never，这个文件的优先级比全局settings.json高，会直接覆盖你的配置，按需求修改对应参数即可
• 检查C_Cpp: Clang_format_fallback的值，如果设成了Google风格，这个风格默认是强制删除括号前后所有空格的，改成LLVM或者Visual Studio就恢复正常

容易碰到的误区 #

• 手动改完settings.json里的clang-format规则后，设置面板上那个「括号前后添加空格」的勾选状态可能会显示异常，这是C/C++扩展的已知UI bug，不用纠结UI上的勾选状态，实际格式化效果以settings.json里写入的内容为准
• 你列出的三个已安装插件（C++ Light主题、CMake、CMake Tools）都不会干扰C++格式化流程，也没有Prettier接管格式化的风险，不需要额外卸载插件

内容的提问来源于stack exchange，提问作者EddieM