小张刚交完作业,被老师叫住:“你这代码跑得通,但为什么变量名全用a、b、c?注释就一行‘计算结果’?”他挠头:“反正我看得懂啊。”——可编程不是单机游戏,是团队协作。C++编码标准,就是让代码从“自己能看”变成“别人秒懂”的那套规矩。
命名别玩猜谜
函数名别叫func1(),类名别叫MyClass。推荐驼峰式:函数用calculateTotalPrice(),常量全大写加下划线:MAX_BUFFER_SIZE。变量名要带语义,比如user_input_age比ui_a强十倍。
缩进和空格不是小事
别用Tab混搭空格,统一用4个空格缩进。运算符两边留空格,逗号后面加空格:
if (age > 18 && is_registered == true) {
user_status = STATUS_ACTIVE;
}而不是挤成一团:if(age>18&&is_registered==true){user_status=STATUS_ACTIVE;}
头文件包含有顺序
先系统头文件,再第三方库,最后自己的头文件,每组之间空一行:
#include <iostream>
#include <vector>
#include "json.hpp"
#include "user.h"
#include "config.h"别让if裸奔
哪怕只有一行,也老老实实加花括号:
// ✅ 好习惯
if (score >= 90) {
grade = 'A';
}
// ❌ 别这样,加了新行容易出错
if (score >= 90)
grade = 'A';某次小李删掉一行调试代码,忘了补括号,结果grade赋值逻辑整个跑偏,查了两小时才揪出来。
注释不是装饰品
别写“初始化变量”这种废话。说明“为什么”:比如// 用double避免float在累计求和时的精度漂移;或者解释复杂算法的意图:// 这里用快排分区思想找第k小,不实际排序以节省时间。
标准不是枷锁,是让代码像公交站牌——方向清晰、站名准确、换乘提示到位。你写的每一行,都可能被同事凌晨三点打开修bug,也可能被半年后的自己重新读一遍。把标准当习惯,代码才有温度。