JavaScript变量命名英语指南：避免Chinglish表达

作者：函数茶馆

时间：2026-10-30

针对JavaScript开发中常见的Chinglish（中式英语）变量命名问题，提供词性搭配、词汇精准选型、单复数规范与语法重构全套指南，帮助开发者写出地道、自解释的前端代码。

文章目录

编写高质量 JavaScript 代码时，命名不仅是语法要求，更是团队协作中的一种契约。许多开发者在写变量名时容易受母语语序、字面直译或词性混淆的影响，写出如 isOpenDialog、tableDataList 或 priceAdd 等具有明显中式英语（Chinglish）特征的名称。本文将从词性对应、语法顺序、近义词选型和数据结构表达四个维度，系统讲解如何将中文业务概念精准转换为地道、自解释的英语变量名。

一、中式英语命名的典型症状与成因

很多开发者在写变量名时，往往是在心里先想好中文，然后逐字在词典里查出英文单词并生硬拼接。这种“中英逐字直译”是产生 Chinglish 命名的根源，其主要表现为三种形态：

词序倒置：把中文的“动词在前、名词在后”直接挪用到普通变量名上，例如把“表格数据”写成 dataTable，“新增价格”写成 priceAdd。
词性与意图错位：把动词用在状态变量中，或者把布尔值写成了动作指令，例如用 openModal 表达弹窗当前是否打开。
冗余修饰与机械堆砌：滥用 data、list、info 等泛词，写出诸如 userDataInfoList 这样长而无效的命名。

图 1：三种常见 Chinglish 命名反例及对应的地道表达原则对比矩阵

二、核心语法规则：词性决定命名结构

JavaScript 是一种动态弱类型语言，在缺少显式类型注解的情况下，变量命名承载了 80% 以上的类型与意图暗示。地道的英文命名遵循固定的语法结构搭配：

1. 名词短语：普通值与数据对象

存储数值、字符串或对象的普通变量，必须是名词或定语修饰名词。定语可以是形容词、名词定语或现在分词。

形容词 + 名词：activeUser（活跃用户）、totalPrice（总价格）、remainingTime（剩余时间）。
名词 + 名词（复合名词）：orderId（订单编号）、userProfile（用户资料）。前一个名词充当定语，核心名词在后。
反例：createOrderTime（动词+名词+名词混杂）→ 正例：orderCreatedAt 或 orderCreationTime。

2. 谓词结构：布尔变量（Boolean）

布尔值应当被设计成一个是非疑问句的断言。最地道的布尔值前缀是助动词或系动词，后面接形容词、分词或介词短语：

is + 形容词/名词：isVisible（是否可见）、isAdmin（是否是管理员）、isValid（是否有效）。
has + 过去分词/名词：hasPermission（是否具有权限）、hasLoaded（是否已加载完成）。
can / should + 动词原形：canSubmit（是否能够提交）、shouldRefresh（是否应该刷新）。

注意避免“双重系动词”：有些开发者为了强调“打开”，写成 isOpenDialog，在英文语法中这是完全错误的句子结构。修饰词或者宾语应该在后，正确的顺序是 isDialogOpen 或直接 isOpen。

3. 动宾短语：函数与方法（Function）

函数代表行为动作，必须以动词原形开头，后接操作的宾语或副词：

fetchUserData()（获取用户数据）
validateInput()（验证输入内容）
removeCartItem()（删除购物车商品）

三、中文业务概念到地道英文的选词决策流程

在日常业务开发中，开发者面临的不仅是语法结构，还有词汇精准度的问题。例如“获取”，究竟该用 get、fetch、retrieve 还是 query？以下决策流程图梳理了从业务意图到标准命名的推导路径：

图 2：从业务语意到地道命名代码的四阶推导决策树

四、避坑清单：常见中式用词与精准重构

很多开发者在词汇选择上长期使用少数几个万能词，导致代码语义模糊。下表列举了高频出现的 Chinglish 单词及其地道替换方案：

中文业务意图	常见 Chinglish 表达	地道英文替代词	使用场景解析
获取数据	getData()	fetchData() / queryData() / getUser()	网络异步请求用 `fetch`，本地同步获取用 `get`，带复杂条件检索用 `query` 或 `search`。
修改 / 改变	changeUser()	updateUser() / mutateUser()	业务数据更新普遍用 `update`；状态库底层不可变数据更改常用 `mutate`。
处理点击 / 提交	clickButton() / doSubmit()	handleButtonClick() / onSubmit()	事件处理函数优先采用 `handle + Event` 或 `on + Event` 规范。
数量 / 计数	userNumber / userNum	userCount / userTotal	`number` 多指代具体的编号（如身份证号、工号）；物品数量应使用 `count`。
状态 / 标志	statusFlag / isState	status / state	`flag` 是早期 C 语言残留习惯，现代 JS 中直接使用具体的名词或布尔断言。
弹窗是否打开	openDialog / isShow	isDialogOpen / isVisible	`isShow` 是最臭名昭著的 Chinglish 词汇（英文无此搭配），应使用 `isVisible`。

五、数据结构与集合命名的现代规范

很多刚入行的开发者习惯在变量名后面加上具体的数据类型，如 userArr、orderList、itemMap。在现代化 JavaScript 开发中，过度指明底层类型往往是代码坏味道：

图 3：类型后缀反模式与现代领域意图驱动命名法的架构对比

在命名数组或列表时，记住以下三条核心准则：

使用自然复数：普通的同类型集合直接用复数形式，如 const products = []。在遍历时，products.forEach(product => ...) 天然形成了“复数到单数”的优雅对照。
哈希字典使用维度说明：当使用对象或 Map 充当查找表时，使用 [item]By[Key] 结构，例如 userById 或 productBySku，一眼即可知晓其键值对的结构。
避免不可数名词造成的歧义：对于像 news、information、equipment 这样本身没有复数形式的不可数名词，如果需要表达列表集合，可以使用 newsList、articleItems 或 equipmentGroup。

六、综合总结与审查清单

要彻底摆脱代码中的中式英语，需要在日常编码中建立起条件反射般的代码自审机制。每次定义变量或提交代码审查（Code Review）时，可以参照以下总结清单进行自我核验：

图 4：消除中式英语变量命名的四维自审闭环模型

代码不仅是写给运行时解释器执行的指令，更是写给后续维护者（包括未来的自己）阅读的交流媒介。告别 Chinglish 命名并不需要掌握深奥晦涩的冷门词汇，关键在于摆脱字面逐字直译的思维惯性，尊重英语原生的定语修饰语序、词性对应规则与领域抽象。坚持按照这一标准审视每一行 JavaScript 代码，就能让项目的可读性与专业度迈上一个全新的台阶。