|
类别 |
规范条目 |
示例/说明 |
执行等级(★) |
|
命名规范 |
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 |
文件/网络操作必须异常处理 |
★★★ |
浙公网安备 33010602011771号