技术英语 / 技术文章

变量命名到底该用哪个英文词

变量命名容易卡在一个看似简单的问题:到底该用 get、fetch、load、find,还是 query、retrieve?这篇文章面向需要阅读英文文档、参与开源协作、参加外企或远程团队面试的中文开发者,通过常见动词的语义差异和实际代码场景,最终让变量名更准确,也更容易被团队成员理解。

先区分变量名和动作名

英文动词首先表达的是“怎么得到数据”,而变量名通常表达“数据是什么”。因此,不要看到中文里的“获取”就机械翻译成 get。

例如,下面两个名字表达的重点不同:

javascript
const user = getUser(id)
const fetchedUser = fetchUser(id)

user 强调结果本身,适合已经明确知道数据含义的变量。fetchedUser 则强调“刚刚从外部来源取回来的用户”,当代码需要区分缓存对象、数据库对象和网络返回对象时更有价值。

命名时可以先问一句:这个变量是在描述“对象”,还是在强调“对象是怎么来的”。前者通常优先使用名词,后者才需要保留过程语义。

get、fetch、load 到底怎么选

这三个词都可以翻译成“获取”,但在工程代码里常见的侧重点不同。

词 常见语义 典型场景
get 取得某个值或对象 getter、按 ID 读取、计算得到结果
fetch 从外部来源取回 HTTP、远程 API、网络请求
load 将内容加载到当前上下文 文件加载、配置加载、模块加载

例如:

javascript
const config = getConfig()
const profile = fetchProfile(userId)
const template = loadTemplate(templatePath)

getConfig() 可以只是从内存或配置对象中取得值;fetchProfile() 更容易让读者联想到一次远程读取;loadTemplate() 则暗示内容需要被加载到程序当前的工作环境。

因此,“获取”不是一个固定英文词,而是要结合数据来源和动作结果来判断。

find、search、query 有什么区别

查询类命名最容易出现过度泛化。三个词的区别可以从“目标是否明确”和“范围是否开放”来理解。

find 通常表示从已知集合里找到目标,目标相对明确,例如 findUserById()、findOrder()。

search 更强调搜索过程,通常面对关键词、文本或较大的候选范围,例如 searchProducts(keyword)、searchDocs(query)。

query 更偏向正式查询动作,常见于数据库、查询接口或结构化数据访问,例如 queryOrders(filters)。

typescript
const user = findUserById(id)
const results = searchProducts(keyword)
const orders = queryOrders(filters)

可以把它们简单理解为:知道要找谁时倾向 find,根据条件广泛寻找时倾向 search,表达一次结构化查询操作时倾向 query。

create、make、build、generate 怎么判断

创建类动词的差别主要在“对象是否从无到有”“是否经过组装”“是否强调自动产生”。

create 最通用,常用于创建实体、记录或资源,例如 createUser()、createSession()。

make 更口语化,适合描述制作一个结果,但在正式业务 API 命名中通常不如 create 明确。

build 强调根据已有输入组装结果,例如 buildRequest()、buildQuery()、buildIndex()。

generate 强调根据规则自动产生内容,例如 generateToken()、generateReport()、generateCode()。

一个实用判断方式是:如果动作是“新增资源”,优先考虑 create;如果是“把零件组装起来”,考虑 build;如果是“根据规则产出结果”,考虑 generate。

update、modify、change、set 不要混用

修改类词汇的边界更值得在团队中统一。

update 常表示对象已经存在,现在把它更新到新的状态,适合数据库记录、资源和业务对象。

modify 强调发生了修改,但不特别强调修改前后的业务状态,常用于配置、内容或结构。

change 更通用,适合描述状态、选择、值或行为发生变化。

set 则通常表示“直接把某个值设置成指定值”,尤其常见于属性和状态。

java
user.updateProfile(profile);
config.modify(options);
status.changeTo(ACTIVE);
user.setName(name);

看到 setXxx,读者通常会期待它直接赋值;看到 updateXxx,则更容易期待一次完整的更新操作。保持这种预期一致,比追求“最标准的单词”更重要。

一套可复用的命名判断法

面对拿不准的英文词,可以按四个问题依次判断:

  1. 这个名字描述的是数据本身,还是获取、创建、修改等动作?
  2. 数据来自内存、本地文件、数据库还是远程服务?
  3. 目标是明确对象、范围搜索,还是结构化查询?
  4. 动作是直接赋值、更新已有资源,还是根据规则生成新结果?

最后再检查一个容易被忽略的问题:团队已有代码是否形成了稳定惯例。即使多个英文词都语法正确,只要项目已经普遍使用 fetchUser 表示远程调用,就不应在另一个模块突然改成 retrieveUser 来制造新的词汇体系。

好的变量命名不是把中文逐字翻译成英文,而是让读者只看名字就能预期数据的性质、来源和操作方式。

目录与阅读设置

记录一个想法

变量命名到底该用哪个英文词

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通