C++的编程规范

C++是一种功能强大的编程语言，具有广泛的应用领域。编写高质量、可维护的C++代码需要遵循一定的编程规范。

目录

①命名规范

②头文件和包含

③缩进和空格

④注释

⑤函数和类

⑥错误处理

⑦内存管理

⑧代码风格

---

①命名规范

使用有意义且易于理解的变量、函数和类名。

使用驼峰命名法（camelCase）或下划线命名法（underscore_case）来命名标识符。

避免使用单个字符或缩写作为名称，除非它们在上下文中有明确的含义。

// 使用有意义的变量和函数名
int studentAge = 18;

string GetStudentName() {
    return "Alice";
}

②头文件和包含

使用include guards（头文件保护）来防止多重包含。

只包含实际需要的头文件，避免不必要的依赖关系。

// 使用include guards
#ifndef MY_HEADER_H
#define MY_HEADER_H

// 只包含实际需要的头文件
#include <iostream>
#include <vector>

#endif  // MY_HEADER_H

③缩进和空格

使用统一的缩进风格，例如使用四个空格代表一个缩进层级。

在运算符、逗号和分号之后添加空格，增加代码的可读性。

避免行尾的空格和制表符。

// 使用统一的缩进风格（4个空格）
void processNumbers() {
    int num1 = 10;
    int num2 = 5;

    if (num1 > num2) {
        cout << "num1 is greater than num2." << endl;
    }
}

④注释

使用注释来解释代码的意图、目的和关键逻辑。

为函数、类和复杂的代码块添加适当的注释。

使用注释来提供版权信息和修改历史记录。

// 函数注释
/**
 * @brief 计算两个数的和
 * @param a 第一个数
 * @param b 第二个数
 * @return 两个数的和
 */
int add(int a, int b) {
    return a + b;
}

// 代码块注释
// 这个循环用于计算数组中所有元素的总和
for (int i = 0; i < arraySize; ++i) {
    sum += array[i];
}

⑤函数和类

使用有意义的函数名，准确描述函数的功能。

函数应保持简短、单一的责任，并遵循单一职责原则（SRP）。

类的接口应该明确、简洁，并符合对象的封装性原则。

class Calculator {
public:
    // 使用有意义的函数名
    int addNumbers(int a, int b) {
        return a + b;
    }
};

// 类的接口应该明确、简洁
class Shape {
public:
    virtual double getArea() const = 0;
    virtual double getPerimeter() const = 0;
};

⑥错误处理

使用异常处理机制来处理可预测的错误情况。

在可能引发异常的代码块中使用try-catch语句。

避免在构造函数和析构函数中引发异常，以确保对象的正确创建和销毁。

try {
    // 可能引发异常的代码块
    // ...
} catch (const std::exception& e) {
    // 异常处理代码
    std::cerr << "Exception caught: " << e.what() << std::endl;
}

⑦内存管理

确保正确地分配和释放动态内存，避免内存泄漏。

如果可能，使用智能指针（如shared_ptr、unique_ptr）来管理资源的生命周期。

// 使用智能指针来管理动态内存
std::shared_ptr<int> numberPtr = std::make_shared<int>(10);

⑧代码风格

将大括号放在独立的一行，并遵循一致的缩进规则。

在逻辑操作符之间添加空格，使代码更易读。

使用空行将相关的代码块分隔开，提高代码的可读性。

void processNumbers() {
    for (int i = 0; i < 10; ++i) {
        if (i % 2 == 0) {
            std::cout << i << " is even" << std::endl;
        } else {
            std::cout << i << " is odd" << std::endl;
        }
    }
}