c++编码规范

这学期结合课程要求和查阅通用规范,我逐渐整理出自己的一套编码规范,主要有以下几个方面。
一、在命名上让代码表达清楚

命名是编码中很常见的操作,也容易被忽视。我以前喜欢用 a、b、temp 这类变量名,当时觉得反正自己记得住,但过一周再看,完全不知道 temp 存的是什么。这学期我给自己定了一条原则:变量名要能说明它是什么,函数名要能说明它做什么。变量和函数尽量用能表意的英文单词,避免没有意义的缩写;常量用全大写加下划线,表示这是一个不可变的配置值。比如写算法作业时,max_sub_sum 这样的函数名比 calc 更清楚,MAXN 比直接写 10005 更能说明它代表什么。循环里的 i、j、k 仍然保留,因为规范不是让代码变得难写,而是在需要读懂的地方保持清晰。

二、排版一致

排版看似琐碎,但它会影响别人打开代码时的第一印象。这学期我主要遵守几条规则:用四个空格缩进,不用 Tab,因为不同编辑器对 Tab 的显示宽度不一样,用空格能保证显示一致。大括号统一放在同一行,即使 if 后面只有一行代码也加花括号。以前我觉得这样写麻烦,直到有一次在 if 后面加了一行日志,结果第二行永远执行,才明白这条规则的意义。排版的关键不是审美,而是一致。同一份代码里如果有的地方缩进四个空格,有的地方两个空格,读起来就像忽快忽慢的节奏,很难专注于内容。

三、函数模块化

这学期写编程作业时,我发现自己容易写出几十行甚至上百行的 main 函数,把所有逻辑堆在一起。后来我开始有意识地拆分:main 函数只负责输入输出和调用,核心逻辑封装到独立函数里。比如归并排序,我把它拆成递归划分和合并两个函数,每个函数只做一件事,逻辑清晰,调试时也能快速定位问题。这种做法的好处很直接:当一个函数只承担一个职责时,它的输入输出更容易理解,也更容易复用和测试。

posted @ 2026-10-05 21:38  elecsea  阅读(8)  评论(0)    收藏  举报