本人于2025上半学期编码需要遵守的规范(参考腾讯内部编码规范)以及读数学之美————信息的度量与熵有感

编码的规范可以使代码更加具有易维护性以及编码安全性等等

程序的板式
缩进使用 4 个空格,禁止混用 Tab 键。
行宽限制 80 字符,长表达式在低优先级操作符处换行,操作符置于新行首。
大括号{}独占一行并与代码对齐,即使只有一行代码(如if、for)也必须包含。

注释
文件注释:包含版权声明、功能描述、作者及修改记录。
函数注释:使用 Doxygen 格式,说明功能、参数、返回值及异常。
代码注释:解释复杂逻辑或不直观的实现,避免冗余注释。

标识符命名
类 / 结构体:大驼峰命名法(如UserManager),结构体名加前缀struct_(如struct_UserInfo)。
变量 / 函数:小驼峰命名法(如userCount、processData()),成员变量加前缀m_(如m_userId)。
模板参数:单字母大写(如T、U),复杂场景使用描述性前缀(如TKey、TValue)。
常量 / 宏:全大写加下划线(如MAX_THREADS),宏名加前缀k_(如k_MaxRetry)。

可读性
避免超过 2000 行的文件,保持模块化设计。
代码缩进使用 4 个空格(Java 要求用 TAB 键并设置为 4 格)。
行宽限制 80-120 字符,换行需遵循逗号后断开、操作符前断开等规则。

安全规范
禁止使用无长度限制的字符串操作(如strcpy、sprintf),改用snprintf或 C++ 标准库string。
避免直接传递用户输入到系统调用(如system),防止命令注入。
禁止硬编码敏感信息(如密码、加密密钥),使用配置文件或安全存储。
......
总体上来说我认为编码要简洁易懂的同时不盲目减少代码的输入,应当不失规范,具有正确性,可读性。

数学之美————信息的度量与熵有感
这一章给我的启发,大概就是是学会了用 “不确定性” 的角度看问题。比如做出选择时,那些 “熵值高”(也就是结果不确定)的选择,虽然不确定,但是有可能带来更多新的信息(比如尝试新的领域);而 “熵值低”(结果确定)的选择,虽然安逸,却难有新的建树。再比如学习时,遇到 “熵值高”(看不懂、不确定)的内容,其实是提升认知的垫脚石—— 因为这些内容能帮我们把 “不确定性”变成可能的石子。​
原来数学不只是计算工具,更是一种思维方式。它能帮我们跳出 “凭感觉” 的误区,用更理性、更本质的视角理解世界。

posted @ 2025-10-08 21:32  女啬  阅读(8)  评论(0)    收藏  举报