Visual Studio 2019自定义C++代码格式化规则及自动应用指南

1. 自定义格式化规则文件扩展名确认 #

.vssettings是正确的扩展名，Visual Studio 2019使用该格式文件导入/导出各类编辑器设置，包括代码格式化规则。你可通过「工具 → 导入和导出设置」向导导出已配置的格式化规则，生成的文件即可命名为MyFormattingRules.vssettings供他人导入。

2. 自定义规则配置 #

函数参数格式化（可通过.vssettings实现） #

1. 先在VS中配置规则：打开「工具 → 选项 → 文本编辑器 → C/C++ → 格式设置 → 换行」
2. 找到「函数声明/定义的参数」选项，设置：
   • 单参数函数：选择「不换行」或「仅在超出页宽时换行」，确保单行显示
   • 多参数函数：勾选「每个参数单独占一行」
3. 配置完成后，通过「导入和导出设置」向导导出该规则到.vssettings文件即可。

成员变量自动重命名（.vssettings无法实现） #

.vssettings仅负责格式化布局，不支持自动重命名变量。推荐以下方案：

• VS内置重构：选中变量后使用「重构 → 重命名」（快捷键Ctrl+R,R）批量修正命名；同时在「工具 → 选项 → 文本编辑器 → C/C++ → 代码样式 → 命名」中配置成员变量命名规则，VS会在编写时给出警告提示。
• ClangFormat：自定义.clang-format配置文件，设置成员变量命名前缀为m_，配合VS的ClangFormat扩展实现保存时自动修正。
• ReSharper C++：专业级代码工具，支持自动应用命名规则，可批量修正现有代码的成员变量命名。

3. 保存时自动应用规则及示例文件 #

自动应用规则设置 #

1. 内置格式化自动触发：打开「工具 → 选项 → 文本编辑器 → C/C++ → 高级」，勾选「保存时格式化文档」，保存.cpp/.h文件时会自动应用.vssettings中的格式化规则。
2. 若用ClangFormat：安装VS的ClangFormat扩展后，在「工具 → 选项 → ClangFormat」中勾选「保存时自动格式化」。

示例文件 #

MyClass.h

class MyClass
{
private:
    int m_myVar;
    std::string m_userName;

public:
    // 单参数函数单行声明
    void SetAge(int age);

    // 多参数函数每行一个参数声明
    void CreateUser(
        int userId,
        const std::string& userName,
        bool isActive
    );
};

MyClass.cpp

#include "MyClass.h"

// 单参数函数单行实现
void MyClass::SetAge(int age) 
{
    // 函数逻辑
}

// 多参数函数每行一个参数实现
void MyClass::CreateUser(
    int userId,
    const std::string& userName,
    bool isActive
)
{
    // 函数逻辑
}

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