C/C++ 命名规范：风格、规则与实践详解

2. 变量/属性

C 语言项目通常统一使用 snake_case。C++ 项目可以根据团队习惯选择是否添加成员变量前缀（如 m_），这有助于区分局部变量和成员变量。

// C 语言 - 通常使用 snake_case
int file_descriptor;
char* user_name;
size_t buffer_size;

// C++ - 成员变量通常有特定前缀/后缀
class MyClass {
private:
int m_count; // m_ 前缀
std::string name_; // _ 后缀
static int s_total; // s_ 静态成员
public:
int calculateTotal(); // 公有方法
};

3. 函数/方法

C 语言函数通常使用 snake_case，而 C++ 方法可以根据项目规范选择 camelCase 或 PascalCase。

// C 语言 - snake_case
void process_data(int* data, size_t size);
int get_user_id(const char* username);
bool is_valid_input(int input);

// C++ - camelCase 或 PascalCase
class Calculator {
public:
int add(int a, int b); // camelCase
void CalculateTotal(); // PascalCase
bool isValid() const; // 布尔方法加 is/has 前缀
void setValue(int value); // setter 方法
int getValue() const; // getter 方法
};

4. 类/结构体/类型

无论是 C 的结构体还是 C++ 的类，都推荐使用 PascalCase。

// C 语言结构体
typedef struct linked_list_node {
int data;
struct linked_list_node* next;
} ListNode; // PascalCase 或 typedef 别名

// C++ 类
class NetworkManager { // PascalCase
// 类内容
};

template<typename T>
class SmartPointer { // 模板类同样 PascalCase
// 模板实现
};

// 接口类通常以 I 开头
class ISerializable {
virtual void serialize() = 0;
};

5. 命名空间

命名空间用于组织相关代码，避免名称冲突。通常使用全小写或与公司/项目相关的命名约定。

namespace my_project { // 全小写
namespace utils { // 嵌套命名空间
// 工具函数
}
}

namespace MyCompany { // 公司名可能用 PascalCase
namespace MyProduct { // 产品相关代码
}
}

6. 宏定义

尽量限制宏的使用，特别是在 C++ 中。必须使用宏时，确保名称全大写且具有描述性，避免与其他名称冲突。

// 全大写，谨慎使用
#ifndef HEADER_GUARD_H
#define HEADER_GUARD_H
#define MAX(a, b) ((a)>(b)?(a):(b))
#define DEBUG_MODE 1

// 特殊宏（编译器相关）
#ifdef __cplusplus
extern "C" {
#endif
#endif // HEADER_GUARD_H

7. 文件命名

通常使用小写字母和下划线，保持名称简洁。头文件和源文件应该有一致的命名模式。

• 头文件：my_class.h (普通), my_class_impl.h (实现细节), my_class_test.h (测试)
• 源文件：my_class.cpp (C++), my_class.c (C), my_class_impl.cpp (实现), my_class_test.cpp (测试)
• 模块文件：my_module_internal.h (内部), my_module_public.h (公共 API)

四、特殊命名规则

某些特定类型的元素有特殊的命名约定，这些约定有助于快速识别元素的性质和用途。

1. 布尔类型

布尔变量和函数应该清楚地表达其真值条件，通常使用 is、has、can 等前缀。

bool is_ready; // is_ 前缀
bool has_permission; // has_ 前缀
bool can_execute; // can_ 前缀
bool should_retry; // should_ 前缀

2. 迭代器/指针

迭代器通常简写为 it，指针可以使用前缀如 p，但现代 C++ 中裸指针使用减少，这一约定也逐渐淡化。

std::vector<int>::iterator it; // 迭代器
std::vector<int>::const_iterator cit; // 常量迭代器
int* p_data; // p_ 指针前缀
char* sz_string; // sz 零结尾字符串

3. 异常处理

异常类应该清楚地表明错误类型，通常以 Error 或 Exception 结尾。

class NetworkError : public std::exception { // Error 后缀
// 异常类
};

throw InvalidArgumentException("Bad argument"); // Exception 后缀

五、代码示例对比

通过对比 C 语言和 C++ 现代风格的完整示例，可以更清楚地理解不同命名规范在实际项目中的应用。

1. C 语言风格

典型的 C 语言项目使用全小写 snake_case，宏定义全大写，结构体使用 typedef 创建类型别名。

// constants.h
#ifndef CONSTANTS_H
#define CONSTANTS_H
#define MAX_BUFFER_SIZE 4096
#define DEFAULT_TIMEOUT_MS 5000

typedef struct user_account {
int id;
char username[50];
double balance;
} UserAccount;

int create_user(const char* username, const char* password);
double calculate_interest(double principal, double rate, int years);
#endif

2. C++ 现代风格

现代 C++ 项目通常使用命名空间、类封装，成员变量有明确的前缀/后缀区分。

// UserAccount.hpp
#pragma once

namespace BankingSystem {
constexpr int MaxBufferSize = 4096;
constexpr int DefaultTimeoutMs = 5000;

class UserAccount {
private:
int m_id;
std::string m_username;
double m_balance;
public:
UserAccount(const std::string& username);
int getId() const { return m_id; }
const std::string& getUsername() const { return m_username; }
bool deposit(double amount);
bool withdraw(double amount);
double calculateInterest(double rate, int years) const;
bool isValid() const;
};
} // namespace BankingSystem

六、最佳实践建议

在团队开发中，应该在项目初期就制定并文档化命名规范。定期进行代码审查，确保规范得到遵守。对于遗留代码，逐步重构而非一次性重命名。

• 选择一种风格并坚持：一致性比具体风格更重要
• 避免使用缩写：除非是广泛接受的（如 HTTP、URL）
• 描述性命名：calculateMonthlyInterest() 优于 calcInt()
• 长度适中：通常 3-20 个字符
• 避免保留字：不要使用语言关键字
• 团队统一：遵循团队的代码规范

命名规范是编程风格的重要组成部分，其不仅影响代码的可读性，也直接关系到项目的可维护性和团队协作效率。在 C/C++ 这样灵活且历史悠久的语言中，存在多种命名约定，没有绝对的"正确"标准。关键是在项目初期明确选择一套规范，并在整个代码库中严格执行。好的命名应该是"自文档化"的——通过名称就能清晰理解其含义和用途，这是衡量命名质量的重要标准。无论选择哪种风格，坚持一致性原则，结合具体项目需求和团队习惯，才能让命名规范真正为代码质量服务。