知用堂
第二套高阶模板 · 更大气的阅读体验

C++变量名命名:写代码像写日记一样清楚

发布时间:2025-12-15 00:17:47 阅读:480 次

早上煮咖啡的时候,你不会把糖罐子叫作‘盐盒子’吧?写代码也一样。变量名起得好,读起来就像在看一段清晰的对话,谁都能明白你在做什么。

别让变量名变成谜语

见过这样的代码吗:

int a = 25;
int b = 180;
double c = b * 0.6 + a;

猜猜 a、b、c 是啥?年龄?身高?体重计算?换成下面这样呢:

int age = 25;
int height_cm = 180;
double recommended_water_ml = height_cm * 0.6 + age;

一眼就知道这是在算每天该喝多少毫升水。健康生活讲究科学饮水,代码里的变量名也得为“健康”的逻辑服务。

用生活语言命名,不是数学代号

很多人初学 C++ 时习惯用单个字母,像是从数学课搬过来的。但代码不是公式推导,它是给机器执行、给人看的。比如你要记录一天走了多少步:

int s = 8000; // 步数?秒数?速度?

换成:

int daily_step_count = 8000;

别人看你代码,甚至你自己三个月后再看,都不用重新破译。

驼峰还是下划线?选一个你舒服的

有人喜欢 dailyStepCount(小驼峰),有人偏爱 daily_step_count(下划线)。C++ 没强制规定,关键是统一。就像你家厨房的调料瓶,要么全用标签贴纸,要么全靠颜色区分,混着来就容易出错。

团队合作时,最好提前约定风格。一个人写成 maxHeartRate,另一个写成 min_heartrate,读起来就像一半普通话一半方言,累。

避开关键字,也避开歧义词

别用 classint 这种关键字当变量名,编译器会翻脸。也不要用太模糊的词,比如 datavaluetemp。就像你不会把药盒上只写“吃的”,代码里也不能只写“临时值”就完事。

要是真需要临时变量,至少说明它临时干啥:

double temp_bmi_calc = weight_kg / (height_m * height_m);

长度不是问题,清晰才是

有些人怕名字太长,其实现代编辑器都有自动补全。敲两个字母就弹出提示,多打几个字符换来的是少花十分钟去猜含义,划算。

比如监测睡眠质量的程序:

int sleep_duration_minutes = 420;
bool is_sleep_interrupted = true;
double sleep_quality_score = 7.8;

这些名字不短,但一目了然。就像体检报告,项目名称写清楚了,谁都能看懂。