交流讨论: 社区通用代码格式化 - .clang-format配置文件 / 格式化工具

[FrozenLemonTee]

目标

通过.clang-format配置文件自动处理项目源代码的缩进、空格等排版问题。

[SakuraKy]

请问社区是否有偏好的基础风格（比如 Google 风格或 LLVM 风格）？

[Sunrisepeak]

请问社区是否有偏好的基础风格（比如 Google 风格或 LLVM 风格）？

会借鉴他们一下, 其他人也可以反馈或提供想法. 最后会具体的风格和实践放到这个仓库, 以及会写一些格式化工具进行辅助之类的

[Sunrisepeak]

@SakuraKy 目前更新了初步的格式文件

• add agent skills and .clang-format #9
• https://github.com/mcpp-community/mcpp-style-ref/blob/main/.clang-format

[FrozenLemonTee]

标准部分注明为c++23的话，格式化会报错：

Error reading D:/project/open_source/D2MySTL/.clang-format: Invalid argument
D:/project/open_source/D2MySTL/.clang-format:2:11: error: unknown enumerated scalar
Standard: c++23
          ^~~~~
Error reading D:/project/open_source/D2MySTL/.clang-format: Invalid argument

可以改为：

Standard: Latest

[Creativecole]

请问一下这个代码风格配置是否符合mcpp规范：

---
Language: Cpp
Standard: Latest

IndentWidth: 4      # 缩进宽度：4空格
TabWidth: 4         # Tab宽度：4空格
UseTab: Never       # 不使用Tab，只用空格
AccessModifierOffset: -4  # 访问修饰符(public/private)向左缩进4空格

BreakBeforeBraces: Attach  # 大括号附加在声明同行（如 if (x) {）

PointerAlignment: Left  # 指针/引用符号紧贴类型（int* p）

SpaceBeforeCpp11BracedList: true  # 在 ) 和 { 之间加空格：func( {1, 2} )
Cpp11BracedListStyle: false       # 保留 {} 内部空格：{ 1, 2, 3 }

AlwaysBreakTemplateDeclarations: Yes  # 模板声明总是换行：template<typename T>\nclass X

AllowShortFunctionsOnASingleLine: Empty  # 只有空函数可以单行

配置效果预览

namespace xxx {

template <typename T, std::size_t N>
class Array {
private:
    T data_[N];
    std::string name_;

public:
    Array() = default;
    Array(std::string name) : name_(name) {}

    constexpr std::size_t size() const noexcept {
        return N;
    }

    constexpr T& at(std::size_t index) {
        if (index >= size()) {
            throw std::out_of_range { "Index out of range" };
        }
        return data_[index];
    }

    void function() {}

    std::vector<int> v { 1, 2, 3 };
};

} // namespace xxx