1. 先说点实在的为什么“命名”这件事值得占掉一天的内容我在团队里做Code Review的时候常说一句话一个变量名写得好不好比你的算法酷不酷更影响你在同事那里的口碑。算法看不懂可以问命名一塌糊涂那就是纯粹的灾难。今天这篇Day2我们专门聊常量与变量名的使用。很多教程把这块当作“入门第一天随便讲讲就过了”的内容但实际工作中你会发现三五年经验的人照样在命名上踩坑。比如热搜里那几条东西“表达式必须含有常量值”、“c# 变量名后加?”、“vue3 项目全局静态常量”、“哪组变量名称是合理的”——这些全是新手常搜的高频问题而且答案并不像表面看起来那么简单。这篇内容适合三类人刚学编程、正在记笔记准备打基础的新手从一门语言跳到另一门语言、被常量定义方式搞晕的转语言开发者以及写RPA脚本、写数据分析脚本这类“非正统开发工种”、想把变量管理做得更规范的朋友。我尽量把原理和实操揉在一起讲你看到的不只是“变量名怎么起”还有“为什么这个报错会出现”“不同语言对常量的定义为什么不一样”这些背后的门道。2. 常量与变量的本质区别先从“变量是盒子”这个老比喻开始纠偏2.1 变量的本质是给内存地址起个“人名”很多教材喜欢说“变量是装数据的盒子”这个比喻能帮新手起步但很容易造成误解。真实的逻辑是这样的你在代码里写int age 25;实际上是两件事——第一向操作系统申请了一块能存放整数的内存空间第二把这块空间的地址跟名字age绑定。之后你写age编译器知道你在说“地址0x7ffc1234那块内存里存的值”。为什么要专门讲这个因为只有理解了这层关系你才能明白变量名本身不占多少存储它只是编译器和人类之间的“翻译标签”变量名的核心功能是让代码可读而不是让机器理解——机器只认地址所以变量名规范与否影响的不是程序能不能跑而是别人以及三个月后的你自己能不能看懂。这个认知直接影响后面所有关于命名规范的讨论。2.2 常量不是“不能变的变量”它分编译期常量和运行期常量新手最容易混淆的一句话是“常量就是值不能变的变量”。这个说法不准确。准确地说常量分两类它们的限制条件完全不同编译期常量在程序编译阶段它的值就已经确定并被“写死”进代码里。编译完成后你甚至可以把存放它的那部分内存当成字面量来理解。典型代表是C语言里的#define、C#里的const、Java里声明时就赋值的static final。运行期常量程序运行起来以后给它赋值的时机可能是构造函数或者初始化代码一旦赋值就不能再改。典型代表是C#里的readonly、Java里在构造函数中赋值的final字段。用生活类比的话编译期常量像刻在石碑上的数字工厂出厂时就铸死了运行期常量像一把带密码锁的保险箱你可以设置初始密码但设置之后就不能改了。这个区别是后面理解“表达式必须含有常量值”这个报错的关键先记在这里。2.3 为什么代码里必须存在常量聊聊“魔法数字”的坏味道你写代码的时候肯定见过这类写法if (user.Status 3) { // 做一些操作 }这个3是什么含义订单已发货账户已冻结还是性别女没人知道。这种在代码里直接出现的裸数字行业里叫魔法数字Magic Number堪称可读性杀手。改成常量之后就不一样了if (user.Status UserStatus.Frozen) { // 做一些操作 }一眼就能看懂判断条件。这就是常量的第一个价值给没有任何语义的字面量赋予有意义的名称。第二个价值是维护性。假设这个3代表的业务含义在数据库里被改成了4如果用魔法数字你必须在整个项目里搜索所有出现3的地方还得小心翼翼判断哪个3是状态、哪个3是别的逻辑如果用了常量只需要改一处定义。所以常量不是编程的“限制”反而是防止你手滑改错、防止后来人误读的安全网。3. 变量命名的硬规则哪些名字在语法层面就直接不合格3.1 几乎所有语言都共通的四条红线变量命名先别谈风格先谈“能不能编译通过”。绝大部分主流语言C、C、Java、C#、JavaScript、Python、Go等在这几条规则上是一致的只能由字母、数字、下划线_和美元符号$组成。注意$在部分语言里合法比如JavaScript/Java但强烈不建议用在业务代码里因为它在很多框架中有特殊用途。不能以数字开头。1variable可以直接判死刑variable1则没问题。不能是语言的关键字。比如你没法在Java里写int class 1;因为class是关键字。大小写敏感。UserName和username是两个不同的变量这一点在排错时特别容易坑人——眼睛扫过去一模一样编译器却告诉你未定义。这里有个小差异值得提Python还允许变量名包含中文等Unicode字符比如total_金额 100在语法角度是合法的甚至某些中文编程场景下能提升可读性。但实际项目里我个人的建议是尽量别用因为主流代码库、第三方库、IDE的自动补全对非ASCII字符的支持参差不齐容易在跨平台协作时出幺蛾子。3.2 命名风格之争下划线、驼峰、帕斯卡到底该用哪个语法过关之后下一个问题就是风格。不同语言社区有不同的约定这叫“社区惯例”你不遵守它代码能跑但内行一眼就知道你是外来的风格示例主要使用场景snake_case下划线命名法total_amountPython、Ruby、Rust 的函数和变量camelCase驼峰命名法totalAmountJavaScript、TypeScript 的变量和函数、Java 的变量PascalCase帕斯卡命名法TotalAmountC# 和 Java 的类名、方法名部分语言CONSTANT_CASE全大写下划线MAX_RETRY_COUNT几乎所有语言的常量kebab-case烤肉串命名法total-amountHTML的>#define MAX_SIZE 100 const int WINDOW_WIDTH 800;#define是预处理器宏它在编译之前直接把代码里的MAX_SIZE文本替换成100不参与类型检查。它的问题在于没有类型、调试器里看不到符号、如果宏定义得过于复杂还容易引发各种诡异错误。const是C89引入的真正的常量修饰符有类型参与编译检查。但C的const有个历史遗留的别扭它只是“通过变量名不能改”不代表编译器一定会把它当作编译期常量。而C从C11开始引入了constexpr明确要求编译器在编译期就算出结果constexpr int ARRAY_COUNT 10; int arr[ARRAY_COUNT]; // OKC语言里要是写const int N 10; int arr[N];早期标准里编译器可能直接报错因为在数组长度这个场景下C要求的是“整数常量表达式”。这个差异导致不少从C转C的人踩坑。所以记住一条C用宏做数组大小C优先用constexprC#和Java也有类似逻辑见下文。4.2 C#的const与static readonly热搜里“C#变量名后加?”是什么C#里的常量分两种这直接对应前面说的编译期常量和运行期常量public class Settings { public const int MaxRetryCount 3; // 编译期常量 public static readonly string ConfigFilePath; // 运行期常量 static Settings() { ConfigFilePath Environment.GetEnvironmentVariable(CONFIG_PATH); } }const要求右边的赋值表达式必须在编译期就能求值所以连array.Length这种运行时才知道的值都不行。static readonly则灵活得多它允许你在构造函数或静态构造函数里赋值一旦赋值后就不能再改。再说热搜词里那条“C#变量名后加?”。这个问号不是变量命名的一部分它是可空值类型Nullable标记。int? count null;表示count要么存一个整数要么存null。从C# 8.0开始引用类型也可以声明可空性比如string? name作用是给编译器一个信号这个引用可能为null请帮我做判空检查。如果你在变量名后面看到一个问号先不要琢磨名字怎么起要理解它是类型层面的修饰。这个点经常和“变量名使用”问题混在一起出现因为教程都喜欢用int? a 100;这种示例新手一看就懵。4.3 Java的static final大多数情况下这就是“常量”Java没有const关键字你没看错const是保留字但不能用日常写常量全靠组合修饰符public static final int MAX_CONNECTIONS 100;这里有个容易被忽略的细节final修饰的是“引用不能改”如果这个常量是对象类型比如static final ListString NAMES new ArrayList();你没法重新给NAMES赋值但可以往这个List里加数据。所以Java里要真正定义不可变集合还得配Collections.unmodifiableList之类的手段。同理JavaScript的const和Java的final在这一点上行为非常像——绑定不可变但对象内容可修改。4.4 Python和MATLAB没有真常量的语言怎么约定Python官方文档明确说了Python里没有不可变绑定的常量机制。PEP 8的建议是模块级常量用全大写加下划线命名比如MAX_RETRY_COUNT。这只是约定你改了也不会报错靠的是团队自觉。Python 3.8之后有了typing.Final可以给类型检查器如mypy、Pyright标注“这个变量不应该被重新赋值”但运行时依然是可变的。所以你在Python里写MAX_SIZE: Final 100 MAX_SIZE 200 # 类型检查器会提示错误但运行时照样执行成功MATLAB的情况类似它没有强制的常量声明语法常见做法有两种一是全大写变量名当常量用二是用一个函数文件返回固定值function val MAX_SPEED() val 120; end这也解释了热搜词里“matlab 转换为字符串常量”的用法——在MATLAB里把数字转成字符串通常用num2str或sprintf然后赋值给全大写的“常量”变量名。本质上还是靠命名约定撑场面。4.5 Vue3项目的全局静态常量撸一个推荐方案最后处理热搜词里的“vue3 项目全局静态常量”。在Vue3项目里全局静态常量最朴素的方案就是建一个src/constants目录然后模块级导出// src/constants/app.js export const APP_NAME MyApp export const DEFAULT_PAGE_SIZE 20 export const STATUS_CODE Object.freeze({ SUCCESS: 0, ERROR: 1, })组件里直接import { APP_NAME } from /constants/app就行。如果你的需求是跨组件共享状态那应该用Pinia的store如果是构建时可替换的配置比如不同环境有不同的接口地址那应该放环境变量文件.env配合import.meta.env使用。全局静态常量这个概念90%的Vue3场景都不需要依赖注入或者Vuex一个常量模块文件就能解决别过度设计。5. 热搜里“表达式必须含有常量值”报错完整排查链路5.1 报错到底在说什么这句报错是很多从C转C#或者从老教科书学C语言的人绕不过去的坎。常见触发代码长这样public class Demo { private const int ArrayLength GetLength(); static int GetLength() { return 10; } }编译直接报错“表达式必须含有常量值”。报错的位置指向const int ArrayLength GetLength();这一行。先别急着改代码我们来拆解一下报错的含义C#的const要求初始化表达式在编译阶段就能计算出确定的值。而GetLength()是一个方法调用编译器在编译时根本不知道这个方法返回什么——只有运行时执行到才知道。这就像你要在印刷书籍付印之前就必须确定封面上的页码但页码要等书装订完才知道逻辑上就不成立。5.2 第一步排查判断你到底需要编译期常量还是运行期常量遇到这个报错先问自己一个问题这个“常量”的值是在程序编译时就能确定还是必须要等程序运行起来、读配置文件或算出来的那一刻才知道如果是前者比如最大重试次数、页面大小、数学里的π直接改成字面量赋值就行但要注意字面量本身得是编译期可求值的比如const int MaxRetryCount 3;可以const int MaxRetryCount 1 2;也可以因为1 2编译器能当场算出3。如果是后者比如从配置文件读的路径、从环境变量取的密钥、调一个方法算出来的结果那就别用const了改用static readonlypublic class Demo { private static readonly int ArrayLength GetLength(); static int GetLength() { return 10; } }5.3 第二步排查同样是C语言为什么数组长度能用#define不能用const类似的坑在C语言里也有变体。看这段经典代码#define N 10 int arr[N]; // 可以N被替换成字面量10 const int M 10; int arr[M]; // 在某些编译器/标准下报错或警告原因是C语言的数组长度要求“整数常量表达式”#define N 10在预处理阶段就已经被替换成10这个字面量天然满足要求。而const int M 10在C语言里是一个“const限定的变量”它的值在编译期不一定被当作常量参与数组大小的计算。C99引入了可变长数组VLAint arr[M];有时候又能编过了但一旦M不是常量这个数组大小就变成了运行时决定行为又不一样。所以C语言里写定长数组老派的正确姿势反而是#define。C的情况完全不同C的const int M 10;默认就是内部链接且可用于常量表达式只要初始化器是常量表达式所以int arr[M];在C里反而没问题。这就是同样一行代码换个语言行为就不一样的典型例子排查时要特别注意你手里的语言标准。5.4 第三步排查怎么快速确认当前编译器的“常量能力”如果你不确定当前的写法能不能当作编译期常量有一个通用土办法把它用在数组长度里试一下——因为数组长度是要求最严格的场景之一。在C#里试试int[] arr new int[SomeConst];如果这里不报错说明SomeConst被编译器认可为编译期常量如果报“表达式必须含有常量值”就说明它不是。在C里同理std::arrayint, N arr;的N要求模板非类型参数也必须是个编译期常量。这个“数组长度测试法”我几乎在每次技术答疑里都会教简单直接又准确。6. 从RPA到后端项目命名实践怎么在真实场景里落地6.1 我在项目评审里最常挑的命名毛病做过多年代码评审我总结出几类反复出现的命名问题今天一起说了第一类是“类型后缀滥用”。有些老派开发喜欢把所有变量都带类型后缀比如strUserName、intCount、lstItems。这是早年VB时代的匈牙利命名法遗风。现代语言基本都有类型推断C#的var、C的auto、TypeScript从JavaScrip继承的宽泛性类型信息IDE里鼠标一悬停就能看到写在变量名里纯属噪音。我一般建议除非团队规范明确要求否则不要给变量名加类型前缀。第二类是“缩写过度”。usNm想表达user namecnt想表达counttm想表达time。缩写是为了省打字时间但读代码的人每次都要做一次“缩写解码”长期来看团队效率是下降的。折中方案是不超过5个字母的短词尽量全拼超过5个字母的常用词可以用通用缩写比如msg对message、btn对button但缩写表必须团队统一。第三类是“中文拼音混搭”。这一条对国内开发者尤其常见。zhangDanList账单列表、keHuId客户ID这类名字拼音和英文混在一起读起来非常难受。解决方案只有一条统一的语言风格。要么全英文推荐要么纯拼音不建议但不混搭别一字英文一字拼音。6.2 RPA脚本里变量命名的特殊场景热搜词里的“rpa数据表文件变量”我猜是写RPA流程比如用影刀、UiPath这类工具时流程面板上自动生成了一堆变量1、变量2、数据表_1。RPA工具有个特点它没有传统代码的“作用域可见性”那么强变量全局挂在面板上一多就乱。我的经验是给RPA变量名加一个“职责前缀”例如表格类的dt_订单明细、dt_客户表路径类的path_导出文件夹、file_模板Excel业务状态类的flag_是否已处理、count_本轮循环次数这样在流程面板里按前缀查找效率非常高。别嫌麻烦一个几十步的RPA流程到后期维护变量时你会感谢当初分类的自己。6.3 命名自查清单写完代码先过这五关我现在给团队定的验收标准很简单变量名必须满足以下五条才算“合格”读得出含义一个不熟悉业务的新人看到这个名字能不能大致猜出它存什么不用查注释如果变量名本身已经表达清楚旁边注释基本是多余的不与其他变量混淆studentName和studentName1这种组合就别出现长度适中建议3到20个字符之间过短没信息量过长阅读负担重符合团队风格统一用项目约定的命名风格别今天驼峰明天下划线。这套清单看着朴素但配合Code Review执行下去比什么高深的架构设计更容易快速提升代码质量。我见过最夸张的一次事故一个结算模块里有人把两个订单金额变量起名为money1和money2后来一次需求变更只改了money1没改money2线上直接算错账。排查了三个小时才定位到最后发现就是命名没表达清楚“这个钱到底是哪笔订单的钱”。从那以后我们对命名规范的执行就严格多了。写代码这事儿语法决定你今晚能不能下班命名决定你下个月还能不能看得懂自己写的代码。今天这篇聊完建议你自己动手做个小练习翻开最近写的一个程序把所有变量名列个清单挨个问自己“这个名字能不能让一个没看过代码的人猜到用途”。能想清楚这个问题今天的Day2就真正过关了。