C++ Linux下代码风格规范

在Linux环境下写C++，代码风格这件事，说大不大，说小不小。但如果你经历过几个项目的迭代，或者团队协作时被队友的“神代码”折磨过，就会明白：一套清晰的风格规范，真的能救命。它能极大提升代码的可读性、可维护性，更重要的是，减少那些因为格式混乱引发的无意义争论。下面这些点，算是实践中沉淀下来的共识，值得花几分钟过一遍。

1. 缩进和空格

• 缩进统一用4个空格——别碰Tab键，真的。不同编辑器对Tab的渲染天差地别，用空格能保证在任何环境下代码都整整齐齐。
• 操作符两边加空格，像 a = b + c; 这样，读起来一目了然。逗号后面也别忘了空格，比如 for (int i = 0; i < n; ++i)，视觉上更清爽。

2. 命名规范

• 类名用大驼峰（CamelCase）：class MyClass {}，一看就知道是个类型。
• 函数名和变量名用小驼峰（camelCase）：void myFunction()，区分清晰，不易混淆。
• 常量名全大写加下划线：const int MAX_SIZE = 100;，一眼就能认出这是不可变的。
• 枚举类型名也用大驼峰：enum Color { RED, GREEN, BLUE };，枚举值反而全大写，这是惯例。

3. 注释

• 大块代码需要注释掉时，用 /* ... */；单行注释用 //，干净利落。
• 注释的核心是解释“为什么这么写”，而不是“写了什么”——代码本身已经说明了它做了什么，你要交代的是背后的权衡和思路。比如：“这里用了map而非unordered_map，因为需要有序遍历”。

4. 头文件包含

• 顺序有讲究：先标准库（之类），再第三方库（如Boost），最后是自己的自定义头文件。这样能尽早暴露依赖问题，也方便阅读。
• 避免重复包含：要么用传统的头文件保护宏（#ifndef XXX_H），要么直接上 #pragma once——后者更简洁，但注意不是所有编译器都保证支持（现在主流都已OK）。

5. 函数和方法

• 一个函数只做一件事，尽量简短。如果函数体超过屏幕高度，就该考虑拆分了。
• 参数列表里，常量参数放在非常量参数之后。这样调用时容易区分哪些是可变的。
• 返回值类型要明确。如果类型冗长，可以用 auto 来简化——前提是读者能一眼看出返回的是什么。

6. 错误处理

• 用异常代替返回错误码。C++的异常机制能更好地分离错误处理逻辑和正常业务逻辑。
• 注意异常安全：抛出异常时，确保之前分配的资源已经被妥善释放。RAII（资源获取即初始化）是法宝。

7. 内存管理

• 尽可能用智能指针：std::unique_ptr 和 std::shared_ptr 能自动管理生命周期，比手动 new/delete 安全得多。
• 避免内存泄漏和悬挂指针——这是C++的老大难问题，智能指针是当前最优解。

8. 代码组织

• 把功能相关的函数和数据结构放在同一个文件里，别东一榔头西一棒槌。
• 用命名空间来划清界限，尽量避免全局变量——那玩意儿在大型项目中是灾难的种子。

9. 版本控制

• Git是标配了，不必多说。
• 提交信息要写清楚：这次提交做了什么、为什么做。别写“fix bug”这种含糊其辞的话，至少指出是哪个模块、什么场景下的bug。

示例代码

#include 
#include 

// 定义一个枚举类型
enum class Color {
    RED,
    GREEN,
    BLUE
};

// 定义一个类
class MyClass {
public:
    // 构造函数
    MyClass(int size) : size_(size) {}

    // 成员函数
    void printSize() const {
        std::cout << "Size: " << size_ << std::endl;
    }

private:
    int size_;
};

int main() {
    // 创建一个MyClass对象
    MyClass obj(10);
    // 调用成员函数
    obj.printSize();
    return 0;
}

这些规范不是教条，而是无数项目踩坑之后总结出的经验。遵循它们，能让你的C++代码在Linux下读起来像散文一样流畅，维护起来也省心得多。