azure011328

导航

 

类别

规范条目

示例/说明

执行等级(★)

命名规范

1. 类/结构体使用大驼峰式

class DataParser; struct UserInfo;

★★★★

 

2. 函数名使用小驼峰式

void calculateTotal();

★★★★

 

3. 局部变量使用小写+下划线

int student_count;

★★★★

 

4. 宏/常量全大写+下划线

#define MAX_SIZE 100 const int TIMEOUT_MS = 5000;

★★★★

格式规范

1. 缩进=4空格(禁用Tab)

IDE中设置强制空格缩进

★★★★

 

2. 函数长度≤50行(超过需拆分)

通过// ----- 功能描述 -----分隔逻辑块

★★★

 

3. 操作符前后加空格

if (count == 0) sum = a + b;

★★★

注释规范

1. 文件头包含版权/作者/修改记录

见下方模板

★★★★

 

2. 复杂算法必须添加流程图或伪代码说明

使用/* FSM状态机: */注释

★★

 

3. 禁止无意义的注释

禁用i++; // i加1这类注释

★★★★

安全规范

1. 指针使用必须检查nullptr

if (pBuffer != nullptr) { ... }

★★★★

 

2. 敏感操作必须加try-catch

文件/网络操作必须异常处理

★★★

posted on 2025-06-11 08:47  淮竹i  阅读(10)  评论(0)    收藏  举报