技术英语 / 知识点
代码命名英语词汇速查
校验与结果
表示确认某项信息、身份或条件真实可靠,常带有核验意味;适合 verifyToken、verifySignature、verifyEmail 等安全与认证场景。
verify
verify 表示根据可核对的证据、已知值或规则,确认某项信息、身份或结果是否真实、正确或可信;当命名重点是“核验真伪或正确性”时使用它。
边界
verify 通常隐含一个可以作为依据的参照,例如签名对应的公钥、令牌对应的密钥、邮箱对应的验证码。它描述的是核验动作,不保证核验过程一定成功,也不限定 API 必须返回布尔值;具体实现也可能在失败时抛出异常。
在安全场景中,verifyToken、verifySignature 这类名称意味着调用方关心真实性或完整性,而不只是检查字符串格式。
与相邻词的区别
| 词 | 更强调什么 | 典型命名 |
|---|---|---|
verify |
根据依据确认真实、正确或可信 | verifySignature |
validate |
判断输入是否满足规则、约束或格式 | validateEmail |
check |
泛化检查,不明确检查标准 | checkStatus |
confirm |
对已有决定、状态或用户意图进行确认 | confirmOrder |
例如,一个邮箱字符串可以先通过 validateEmail 判断格式是否合法,再通过 verifyEmail 确认用户确实控制该邮箱。
最小例子
下面的示例把“与已知值核对”命名为 verifyCode,返回核验是否成功。
function verifyCode(input, expected) {
return input === expected;
}
console.log(verifyCode("4821", "4821"));
console.log(verifyCode("0000", "4821"));预期输出:
true
false这里的函数只演示命名语义,不代表生产级验证码比较方案。
常见误解是把所有“是否合法”的判断都命名为 verify。如果只是检查长度、格式、范围等输入约束,validate 通常更准确;只有存在真实性、正确性或可信性核验含义时,verify 才更清晰。
转换与解析
表示把字符串、字节或其他原始输入解析成结构化结果,重点是识别语法与组成关系;适合 parseUrl、parseJson 等命名。
parse
parse 表示按照某种语法或格式读取原始表示,并识别其中的组成关系,产出可进一步使用的结构化结果;当函数核心工作是“理解输入结构”时使用它。
边界
parse 的前提是输入具有可识别的表示规则,例如 JSON 文本、URL、日期字符串或协议报文。解析成功说明输入能够按该语法被解释,但不等于结果已经满足业务约束。
例如 parseUrl 可以把 URL 拆成协议、主机、路径等部分,但“该主机是否允许访问”属于后续校验,不是解析本身。
与相邻词的区别
| 词 | 更强调什么 | 典型命名 |
|---|---|---|
parse |
按语法识别结构和组成关系 | parseJson |
decode |
把编码后的表示还原为可解释数据 | decodeBase64 |
convert |
在两种值或类型表示之间转换 | convertToCelsius |
validate |
判断结果是否满足规则或约束 | validateConfig |
parse 和 decode 有时会同时出现:可以先解码字节,再解析解码后的文本或数据结构。名称应突出函数最主要的职责。
最小例子
JSON.parse 会把 JSON 文本解析成 JavaScript 值,重点是从文本语法得到结构化对象。
const raw = "{\"port\":8080}";
const config = JSON.parse(raw);
console.log(config.port);预期输出:
8080若 JSON 文本语法错误,JSON.parse 会抛出 SyntaxError;解析成功也不代表 port 一定满足应用要求的端口范围。
常见误解是把任何类型转换都叫 parse。如果只是数字单位换算、对象字段映射或编码还原,并没有识别输入语法结构,convert、map 或 decode 往往更准确。
表示把同一信息从一种表示、类型或格式转换成另一种,通常保留核心语义;适合 convertDate、convertToMap 等场景。
convert:转换
convert 表示把同一份核心信息从一种类型、格式或表示形式变成另一种,命名重点是表示发生变化,而业务含义基本保持不变。
边界
当输入与输出描述的是同一信息,只是载体或类型不同,适合使用 convert。例如把日期对象转成时间戳、把配置对象转换成另一种结构,或把某种值转换为目标类型。
如果过程主要是从文本中识别结构,应优先考虑 parse;如果重点是字段之间的对应关系,通常 map 更准确;如果操作会显著改变业务内容,仅用 convert 可能过于宽泛。
与相邻词的区别
| 词 | 命名重点 | 典型含义 |
|---|---|---|
convert |
改变表示或类型 | 同一信息转换为另一种形式 |
parse |
从表示中识别结构 | 从字符串、字节等读取出结构化值 |
map |
建立输入与输出的对应关系 | DTO、模型或集合元素之间映射 |
format |
生成特定展示形式 | 把值组织成面向显示或输出的文本 |
最小例子
convertDateToTimestamp(date) 表达的是“日期信息保持不变,只把表示改成时间戳”。convertUserToDto(user) 虽然能够理解,但如果实现主要是逐字段对应,mapUserToDto(user) 往往更能体现职责。
常见误解是把所有“输入变成输出”的函数都命名为 convert。判断时应先确认变化是否主要发生在类型或表示层;如果核心职责其实是解析、映射或格式化,应选择更具体的动词。
表示建立输入元素与输出元素之间的一一或对应关系,常用于集合转换和模型映射;适合 mapUserToDto 等函数命名。
map:映射
map 表示按照明确规则建立输入与输出之间的对应关系,命名重点是哪些源值、字段或元素对应到哪些目标值、字段或元素。
边界
map 常用于领域模型到 DTO、数据库记录到对象、外部响应到内部模型,以及集合元素逐个生成新元素等场景。它强调对应规则,不要求源类型与目标类型结构完全相同,也不意味着简单复制字段。
如果只是改变同一值的类型或表示,convert 通常更准确;如果输入是文本或字节并需要识别其内部结构,应使用 parse。另外,作为动词的 map 与名为 Map 的键值数据结构不是同一概念,应根据上下文区分。
与相邻词的区别
| 词 | 命名重点 | 典型含义 |
|---|---|---|
map |
源与目标的对应规则 | User 字段映射到 UserDto |
convert |
类型或表示变化 | 日期对象转换为时间戳 |
parse |
从原始表示识别结构 | JSON 文本解析为对象 |
transform |
更一般的结构或内容变换 | 多步骤重组、计算或派生 |
最小例子
mapUserToDto(user) 清楚表达“按照既定字段规则,把一个用户模型映射为 DTO”。对集合执行逐元素映射时,users.map(mapUserToDto) 也体现相同语义:每个输入元素按规则产生对应输出元素。
常见误解是只要函数返回了另一种对象就使用 map。如果实现没有明确的对应关系,而是在解析原始数据、改变表示形式或执行复杂业务计算,使用 parse、convert 或更具体的业务动词通常更准确。
表示把不同形式的输入整理成统一、可比较或可处理的标准表示;适合路径、文本、URL、配置和数据清洗场景。
normalize:规范化
normalize 表示把语义相同但表示形式不同的输入转换为约定的统一表示,便于后续比较、存储或处理;命名时重点表达“统一形式”,而不是改变数据本身的业务含义。
边界
规范化通常允许调整大小写、空白、分隔符、路径片段或其他表示细节,但转换后的值应与原值表达同一类信息。例如把用户名两端空白去掉并转成小写,可以是规范化;把用户名替换成用户 ID,则属于另一种语义转换。
normalize 不保证输出符合所有业务规则。若函数主要判断输入是否合法,更适合 validate;若主要修正某个明确错误,可考虑 sanitize、fix 或更具体的动词。
与相邻词的区别
| 词 | 核心含义 | 典型结果 |
|---|---|---|
normalize |
统一不同表示形式 | 同类数据得到约定表示 |
format |
按展示或输出格式组织内容 | 生成适合展示的字符串 |
parse |
从一种表示中解析结构或值 | 字符串变成结构化数据 |
validate |
判断是否满足规则 | 返回合法性或错误信息 |
例如 normalizePath 通常意味着消除多余路径片段或统一分隔形式;formatPath 更强调如何把路径展示或输出。
最小例子
下面的函数只统一名称的空白和大小写,没有改变名称表达的业务对象。
function normalizeName(name) {
return name.trim().toLowerCase();
}
console.log(normalizeName(" Alice "));预期输出
alice这里使用 normalizeName 比 convertName 更准确,因为结果仍然是名称,只是表示被统一。
常见误解
不要把所有“修改值”的函数都命名为 normalize。如果转换跨越了数据类型或业务语义,例如把订单对象映射成 API 响应对象,更适合 map、convert、transform 或具体业务动词。
速查时可以问一句:输入和输出是否表达同一种信息,只是表示形式被统一? 如果答案是肯定的,normalize 通常合适。
集合与查找逻辑
表示依据条件从集合中保留符合要求的元素,通常不修改原集合;适合 filterActive、filterByStatus 等集合处理命名。
filter:过滤
filter 表示根据一个或多个条件,从集合中保留满足条件的元素并排除其余元素;命名时适合表达筛选动作,而不是查找单个对象、排序或修改元素内容。
边界
filter 的核心结果仍然是一个集合,只是元素数量可能减少。条件可以来自状态、权限、时间或其他谓词,例如 filterActiveUsers、filterByStatus。
在常见集合 API 中,过滤通常不会修改元素本身,也常返回新的集合;但具体是否原地修改仍取决于语言或项目约定,因此不能仅凭函数名推断内存行为。
与相邻词的区别
| 词 | 回答的问题 | 常见结果 |
|---|---|---|
filter |
哪些元素应该被保留 | 零个、一个或多个元素组成的集合 |
find |
哪一个元素满足条件 | 单个元素或空值 |
map |
每个元素应变成什么 | 与输入逐项对应的新集合 |
sort |
元素应按什么顺序排列 | 顺序发生变化的集合 |
如果调用方期望得到所有启用用户,filterActiveUsers 很自然;如果只需要第一个启用用户,则 findActiveUser 更能表达返回值语义。
最小例子
下面的示例从数字集合中保留偶数,元素本身没有被转换。
const numbers = [1, 2, 3, 4, 5, 6];
const evenNumbers = numbers.filter(number => number % 2 === 0);
console.log(evenNumbers);预期输出
[ 2, 4, 6 ]这里的动作是“保留符合条件的元素”,因此 filter 比 map 或 find 更准确。
常见误解
不要因为函数内部写了条件判断就使用 filter。例如 getUserById 即使内部遍历并判断 ID,若最终只返回一个用户,它在调用方语义上仍然更接近 find 或 get。
判断命名时可以直接看返回意图:结果是否仍是一组从原集合中挑出的元素? 如果是,filter 通常是合适的动词。
表示按照指定规则重新排列元素顺序,通常围绕比较器或排序键展开;适合 sortByName、sortDescending 等集合操作命名。
sort
sort 表示按照明确规则重新排列一组元素的先后顺序;当方法、函数或变量承担“改变或产生排序后序列”的职责时,用它能直接表达意图。
边界
sort 的核心结果是顺序发生确定性变化,排序依据可以是自然顺序、比较器或排序键。若只是寻找最大值、筛选元素或计算名次而没有形成有序序列,通常不应仅用 sort 命名。
sortByName、sortByCreatedAt 适合把排序键写进名称;sortDescending、sortAscending 适合强调方向。具体 API 是否原地修改集合取决于语言或库,不能从单词 sort 本身推断。
与相邻词的区别
| 词 | 重点 |
|---|---|
sort |
按规则重新排列全部或主要元素 |
order |
更强调最终顺序或排序规则,部分框架也把它作为排序操作名 |
rank |
为对象赋予名次或等级,不一定重新排列原集合 |
filter |
保留满足条件的元素,不负责确定先后顺序 |
最小例子
下面的例子产生一个升序排列后的新数组,用于体现 sort 所表达的“重新排列”语义。
const values = [3, 1, 2];
const sorted = [...values].sort((a, b) => a - b);
console.log(sorted.join(","));预期输出
1,2,3常见误解是把任何“按某个条件处理集合”的函数都命名为 sort。只有结果的核心变化是元素顺序时,sort 才是准确选择。
表示把多个记录或值汇总成一个整体结果,常见于统计、报表和领域模型;强调从多项输入得到总体信息。
aggregate
aggregate 表示把多项输入按照某种规则汇总成一个整体结果;当函数职责是从一组记录得到统计值、摘要对象或综合结果时,这个词最合适。
边界
聚合的关键是多项输入形成一个更高层级的结果,结果不一定是单个数字,也可以是包含总数、均值、分组统计等字段的对象。单纯遍历、排序或筛选集合不属于聚合,除非最终还进行了汇总计算。
在数据库、报表和领域代码中,aggregateSales、aggregateMetrics 常表示把明细数据合成为统计结果。若函数只是执行一个具体求和操作,sum 往往比宽泛的 aggregate 更精确。
与相邻词的区别
| 词 | 重点 |
|---|---|
aggregate |
强调多项数据汇成整体结果 |
sum |
明确表示数值求和 |
reduce |
强调逐步累积的处理机制,常见于集合 API |
group |
按键把元素分组,本身不一定产生统计结果 |
aggregate 更适合描述业务意图,reduce 更常描述实现机制;一个聚合操作完全可以通过 reduce 实现,但两者并不等义。
最小例子
下面的函数把多个分数汇总成一个总分,体现 aggregate 的“多项输入得到整体结果”语义。
function aggregateScores(scores) {
return scores.reduce((total, score) => total + score, 0);
}
console.log(aggregateScores([10, 20, 30]));预期输出
60常见误解是把任何批量处理都称为 aggregate。如果处理后的结果仍是一组逐项转换的数据,而没有形成汇总结果,通常应考虑 map、transform 等更准确的词。
计算与派生
表示按照明确公式或规则得到数值结果,强调计算过程与结果关系;适合 calculateTotal、calculateRate 等业务函数命名。
calculate
calculate 表示按照明确的公式、规则或已知输入推导出结果,命名重点是“经过计算得到值”,适合总额、比率、距离、折扣等可由确定规则求出的结果。
边界
使用 calculate 时,调用者通常可以预期:输入已经足够,算法或业务规则相对明确,相同输入在相同规则下应得到相同结果。它强调的是求值过程,而不是数据从哪里取得。
因此,calculateTotal 适合根据商品价格、数量和折扣计算总额;如果函数只是从数据库读取已经保存的总额,更合适的是 getTotal、loadTotal 等读取类命名,而不是 calculateTotal。
与相邻词的区别
| 词 | 主要含义 | 典型命名 |
|---|---|---|
calculate |
按明确规则求出结果 | calculateTotal |
compute |
执行计算过程,常见于算法或技术语境 | computeHash |
estimate |
根据有限信息得到近似值 | estimateCost |
calculate 与 compute 都可以表示计算,但前者更常用于业务规则和可解释的数值推导;compute 更容易让人联想到算法处理或底层计算。与 estimate 的关键差异是,calculate 通常不以“允许明显误差”为语义前提。
最小例子
订单有单价 80、数量 3,规则明确规定总额等于单价乘数量,则函数可命名为 calculateTotal。这里结果 240 是依据确定规则计算得到的,不是预测值。
如果只能根据历史订单推测未来消费金额,则应考虑 estimateSpending,因为结果存在不确定性。
常见误解是把所有“返回数字”的函数都命名为 calculateXxx。判断标准不是返回类型是否为数字,而是函数是否真的依据输入和明确规则执行了求值。
表示根据已有信息推算一个不完全精确的结果,通常接受误差范围;适合时间、成本、容量和资源预测等命名。
estimate
estimate 表示根据当前可用信息推算一个近似结果,结果允许存在合理误差;当代码返回的是时间、成本、容量或资源需求的预估值时,这个词能直接传达“不保证精确”的语义。
边界
使用 estimate 的前提是信息不完整、模型经过简化,或者未来条件仍可能变化,因此结果不能被理解为严格确定值。函数可以使用明确公式,但只要公式中的假设、采样或预测因素使结果具有近似性,仍然适合使用 estimate。
例如,根据文件大小和当前传输速率推算剩余下载时间可以叫 estimateRemainingTime。即使计算公式是确定的,网络速率后续可能变化,因此最终时间仍只是估算。
与相邻词的区别
| 词 | 主要含义 | 对结果精度的暗示 |
|---|---|---|
estimate |
基于现有信息给出近似值 | 明确允许误差 |
calculate |
按确定规则求值 | 通常期望确定结果 |
predict |
根据趋势或模型推断未来结果 | 更强调未来事件或状态 |
estimateCost 表示成本值本身是近似的;calculateCost 更像是在价格、数量、税率等输入明确后计算应付金额。predictDemand 则通常强调对未来需求走势的推断,而不只是给当前任务一个近似数值。
最小例子
一个任务根据过去十次构建耗时的平均值推算本次完成时间,可以命名为 estimateBuildTime。调用者看到名称就应知道,这个结果适合展示进度或规划资源,而不应被当作精确截止时间。
如果函数根据固定单价和数量得到账单金额,则应使用 calculateAmount 一类命名,因为这里没有“近似值”的语义。
常见误解是认为 estimate 等于“随便猜一个值”。好的估算仍应建立在可解释的数据、规则或模型上;它与精确计算的区别在于不确定性,而不是是否有计算依据。
表示得到元素、事件或符合条件对象的数量,重点是结果为计数值;适合 countUsers、countFailures 等统计型名称。
count
count 表示对元素、事件或满足条件的对象进行计数,命名重点是得到一个数量值;当函数、变量或字段回答“有多少个”时,可以优先考虑它。
边界
count 适用于结果能够表达为非负整数数量的场景,例如用户数、失败次数、匹配项数量。它既可以表示“执行计数这一动作”,也可以作为复合名称的一部分表示计数结果,具体由命名位置决定。
例如 countUsers 更像“计算用户数量”的函数名;userCount 更像已经得到的“用户数量”变量或字段。若名称表达的是求和、聚合金额或计算比例,则不应仅因为结果是数字就使用 count。
与相邻词的区别
| 词 | 核心含义 | 典型命名 |
|---|---|---|
count |
计算对象有多少个 | countFailures |
size |
容器或集合当前包含多少元素,常强调属性值 | queueSize |
total |
汇总后的总值,可能是数量、金额或其他可累加值 | totalPrice |
sum |
对一组数值执行加法 | sumAmounts |
count 与 sum 最容易混淆:统计 10 个订单得到 10 是计数;把这 10 个订单的金额相加得到 520.00 是求和。
最小例子
一个筛选结果包含 8 个失败任务时,failureCount = 8 表示已经得到的数量;countFailures(tasks) 则表示执行“统计失败任务数量”这一动作。
常见误解是把所有数字结果都命名为 count。百分比、金额、距离、容量等虽然也是数字,但回答的不是“有多少个对象”,应使用更准确的业务词。
可靠性与生命周期
表示失败后再次执行同一操作,通常用于网络请求、任务处理和临时故障恢复;名称应明确重试的是动作而非结果。
retry
retry 表示一次操作失败后,再次尝试执行同一目标操作;命名时通常用于重试动作、重试策略或重试次数,而不是表示最终成功结果。
边界
retry 的前提是已经发生过至少一次尝试,并且后续执行仍针对同一业务目标。网络超时、临时服务不可用、任务竞争失败等可恢复错误常见于重试场景,但是否应该重试取决于操作是否允许重复执行以及错误是否具有暂时性。
如果是第一次执行,应使用 request、send、load、process 等描述实际动作的词;如果失败后改用另一套方案完成目标,则更接近 fallback,而不是 retry。
与相邻词的区别
| 词 | 核心含义 | 关注点 |
|---|---|---|
retry |
失败后再次执行同一操作 | 再尝试 |
repeat |
再执行一次,不要求之前失败 | 重复 |
resume |
从中断位置继续 | 延续进度 |
fallback |
主方案不可用时切换备用方案 | 替代路径 |
例如 HTTP 请求超时后再次发送同类请求属于 retry;下载到 60% 后从断点继续通常属于 resume;主接口不可用后读取缓存则属于 fallback。
最小例子
retryRequest 可以表示“重新尝试该请求”,retryCount 表示已经重试或允许重试的次数,maxRetries 表示重试次数上限。若变量保存的是最终处理结果,则应使用 result、response、status 等描述结果本身的词,而不是 retry。
常见误解是把“重新执行”都称为 retry。没有失败前提的周期执行、用户主动刷新或普通重复操作不一定属于重试;命名应保留“因失败而再次尝试”的语义。
表示从异常或故障状态恢复到可继续工作的状态,强调恢复过程与最终可用性;适合 recoverSession、recoverState 等场景。
recover:从异常状态恢复
recover 表示对象或系统已经进入异常、损坏或不可用状态,随后通过处理使其重新达到可继续工作的状态;命名时重点是从故障中恢复可用性,而不是单纯重新执行一次操作。
边界
recover 通常隐含两个前提:先发生异常或失效,再执行恢复动作。它适合会话中断、状态损坏、任务崩溃、连接异常等场景,例如 recoverSession、recoverState。
如果只是读取持久化数据并还原对象,而没有“发生故障”的语义,restore 往往更准确;如果只是再次执行失败操作,则更接近 retry。
与相邻词的区别
| 词 | 核心含义 | 典型命名场景 |
|---|---|---|
recover |
从异常或故障状态回到可工作状态 | recoverSession、recoverState |
restore |
从备份、快照或已保存状态还原 | restoreBackup、restoreSettings |
retry |
再次执行先前失败的操作 | retryRequest、retryJob |
resume |
从暂停点继续执行 | resumeDownload、resumeTask |
retry 可以是恢复过程中的一个手段,但重复请求成功并不等于已经完成整个系统状态的 recover。
最小例子
用户会话因进程重启而失效,程序根据持久化信息重新建立可用会话,可命名为 recoverSession。如果只是把配置文件中的旧设置重新加载回来,restoreSettings 更能表达动作来源。
常见误解是把所有“重新做一次”都命名为 recover。判断关键是:调用前是否存在明确的异常或不可用状态,以及调用后的目标是否是恢复可用性。
表示处理结束后释放临时资源、状态或副作用,通常用于 finally、关闭连接和任务收尾;强调收尾动作而非删除业务数据。
cleanup:处理结束后的收尾清理
cleanup 表示一次任务、测试、请求或生命周期结束后,清除临时资源、残留状态或附带副作用,使环境回到可继续使用的状态;它强调收尾工作,而不是删除正常业务数据。
边界
cleanup 常用于多个收尾动作的集合,例如删除临时文件、释放锁、移除临时状态或撤销测试数据。它尤其适合调用方不需要关心具体清理细节,只需要表达“把这次处理留下的东西收拾干净”的场景。
如果动作只负责关闭一个明确资源,close 通常更具体;如果对象具有明确的资源生命周期并需要显式释放,dispose 或语言、框架约定的释放词可能更合适。
与相邻词的区别
| 词 | 核心含义 | 典型命名场景 |
|---|---|---|
cleanup |
执行一组结束后的收尾动作 | cleanupTempFiles、cleanupTestData |
close |
关闭已打开的单个资源或通道 | closeConnection、closeStream |
dispose |
结束对象生命周期并释放其持有资源 | disposeClient、disposeContext |
delete |
删除具有业务或持久化意义的数据 | deleteUser、deleteOrder |
cleanup 可以包含 close 或删除临时数据,但它不应掩盖具有独立业务含义的删除操作。
最小例子
测试结束后需要删除临时目录、释放文件锁并清空测试缓存,把这些动作封装为 cleanupTestEnvironment 很自然。若函数唯一职责只是关闭数据库连接,则 closeConnection 比 cleanupConnection 更明确。
常见误解是把任何删除函数都命名为 cleanup。如果调用会永久删除用户、订单等业务对象,应直接使用能表达业务影响的 delete 或更具体的动词,避免弱化破坏性语义。
表示对象、实例或资源生命周期正式结束,通常比 cleanup 更强;适合组件卸载、连接关闭和运行时资源销毁等场景。
destroy
destroy 表示让某个对象、实例或运行时资源正式结束生命周期;命名时看到它,应预期调用后该对象通常不再适合继续按原状态使用。
边界
destroy 强调的是生命周期终止,而不只是清理局部数据。它常用于组件实例、渲染器、会话对象、连接包装器或其他具有明确创建与销毁阶段的资源。
具体销毁动作由所属 API 决定:可能包括释放内存、注销监听器、断开连接或移除运行时资源,但不能仅凭方法名推断一定会删除持久化数据。某些库还允许重复调用销毁方法,另一些则会报错,因此幂等性也不能从 destroy 一词本身推断。
与相近动词的区别
| 词 | 主要语义 | 更适合的场景 |
|---|---|---|
destroy |
正式结束对象或资源生命周期 | 销毁组件、实例、运行时资源 |
cleanup |
清理临时状态或附属资源 | 删除临时文件、清空缓存、收尾 |
close |
关闭已打开的句柄或连接 | 文件、Socket、数据库连接 |
dispose |
释放对象持有的资源 | 明确采用 Dispose 生命周期的 API |
cleanup 完成后主体可能仍然存在并继续使用;destroy 通常表达更强的终止含义。close 和 dispose 是否等同于销毁,则取决于具体框架的生命周期约定。
最小例子
如果一个渲染器创建后注册了事件监听器并持有图形资源,destroyRenderer() 表示结束整个渲染器实例的生命周期;如果只是删除一次渲染留下的临时文件,cleanupRenderFiles() 更准确。
类似地,destroySession() 通常比 cleanupSessionCache() 范围更大:前者指向会话对象本身的终止,后者只说明清理其中一部分缓存状态。
常见误解
不要把 destroy 当成更强烈的 delete。delete 通常强调删除某项数据、记录或集合元素,而 destroy 更强调一个有生命周期对象的终止。命名时应先判断动作是在删除数据,还是在结束对象或资源的生命期。
状态与开关
表示把某项功能、能力或配置切换为可用状态,强调开启后的能力存在;适合 enableCache、enableFeature 等布尔式控制。
enable
enable 表示把某项功能、能力或配置切换到“允许使用、可以生效”的状态;命名时它最适合表达明确的开关动作,例如启用缓存、特性或某种检查能力。
边界
enable 描述的是能力或配置状态变为可用,不一定意味着相关任务已经开始执行。例如 enableCache() 可以表示允许后续请求使用缓存,但并不等于立即执行一次缓存加载。
它通常与 disable 成对出现。若接口表达的是一个布尔开关,也常见 enableFeature()、setFeatureEnabled(true) 或配置字段 featureEnabled;具体采用动作方法还是布尔属性,应遵循项目既有命名风格。
与相近动词的区别
| 词 | 主要语义 | 典型区别 |
|---|---|---|
enable |
让能力或配置变为可用 | 强调开关状态 |
start |
开始一个过程或任务 | 强调执行开始 |
activate |
使对象进入活动状态 | 常用于已有对象、账户或组件状态 |
allow |
允许某个行为发生 | 更偏权限、规则或策略 |
例如,enableScheduler() 可以表示打开调度能力,而 startScheduler() 更像真正启动调度循环;两者在某些 API 中可能同时存在,因此不要仅因为中文都能翻成“开启”就混用。
最小例子
假设应用默认关闭缓存。调用 enableCache() 后,后续读取允许走缓存,这符合 enable 的开关语义;如果方法的实际职责是立即建立缓存并执行首次加载,名称可能需要进一步体现 initialize、load 或 start 等动作。
同样,enableFeature() 表达“让功能可以使用”,而 activateFeatureForUser() 更容易让人理解为“让某个用户当前进入该功能的激活状态”。
常见误解
不要把 enable 理解为“立即执行”。启用日志、缓存、插件或实验功能后,真正的工作可能要等到后续事件触发。判断是否应该使用 enable,关键是看方法的核心结果是否是开关状态发生变化,而不是某个业务流程已经完成。
表示把某项功能或能力切换为不可用状态,通常与 enable 成对出现;适合 disableCache、disableFeature 等配置控制命名。
disable
disable 表示把原本可用的功能、能力或开关切换为不可用状态,通常保留对象本身,只改变其是否允许发挥作用。
边界
disable 最适合描述存在明确启用/禁用开关的能力,例如缓存、按钮、功能标志或某项检查。它通常与 enable 成对,重点是可用性状态发生变化,而不是删除对象、停止整个进程或销毁资源。
如果一个动作会永久移除数据,用 remove 或 delete 更准确;如果对象进入生命周期上的非激活状态,deactivate 往往比 disable 更贴切。
与相近词的区别
| 词 | 核心含义 | 常见命名场景 |
|---|---|---|
disable |
使某项能力不可用 | disableCache、disableFeature |
enable |
使某项能力可用 | enableCache、enableFeature |
deactivate |
让对象退出激活状态 | deactivateAccount |
remove |
从集合或结构中移除对象 | removeListener |
disable 与 deactivate 最容易混淆:前者通常描述功能开关,后者更强调对象生命周期状态。
最小例子
配置项 disableCache 表示关闭缓存能力,但缓存模块或相关配置仍然存在;把账户从可登录状态切换为未激活状态时,deactivateAccount 通常比 disableAccount 更能表达生命周期语义。
常见误解是把所有“停止使用”都命名为 disable。判断时应先确认变化的是某项能力是否可用,还是对象本身的生命周期、存在性或运行状态。
表示让对象、账户、功能或流程进入已激活状态,强调状态从未激活到生效的转变;常用于账户和资源生命周期。
activate
activate 表示让一个已经存在但尚未处于生效状态的对象进入激活状态,强调从未激活到可正式发挥作用的状态转变。
边界
activate 适合存在明确生命周期状态的对象,例如账户、订阅、许可证、资源或工作流实例。它描述的是状态转换,通常不意味着创建对象,也不必然等同于启动一个持续运行的进程。
如果只是打开某项功能开关,enable 通常更自然;如果动作的核心是启动服务、任务或执行过程,start 更准确。
与相近词的区别
| 词 | 核心含义 | 常见命名场景 |
|---|---|---|
activate |
进入激活或正式生效状态 | activateAccount、activateSubscription |
deactivate |
退出激活状态 | deactivateAccount |
enable |
允许某项能力被使用 | enableNotifications |
start |
开始运行或执行 | startServer、startJob |
activate 与 enable 的区别在于:activate 更关注对象从一种生命周期状态进入另一种状态,enable 更关注某项能力是否允许使用。
最小例子
用户完成邮箱验证后调用 activateAccount,表达账户从待激活状态进入有效状态;若只是允许该账户接收通知,命名为 enableNotifications 更直接。
常见误解是把任何“开启”动作都写成 activate。只有当领域模型确实存在激活状态及其转换时,这个词才最清晰;单纯开始执行任务或打开功能开关应优先选择更具体的动词。
表示把已经激活的对象或能力转为非激活状态,通常保留对象本身;适合账户、设备、功能和资源状态管理。
deactivate
deactivate 表示把当前处于激活状态的对象或能力切换为非激活状态,重点是停止其生效或活动状态,而不是删除对象本身。
边界
这个词通常隐含对象已经存在,并且存在 active 与 inactive 一类可切换状态。停用后,对象的数据、身份或配置往往仍被保留,因此之后可能再次激活。
如果操作会永久删除数据,不应仅因为对象“不能再使用”就命名为 deactivate;此时更可能属于删除、撤销或注销语义。
与相邻词的区别
| 词 | 核心语义 | 常见区别 |
|---|---|---|
deactivate |
从激活变为非激活 | 强调状态转换,对象通常保留 |
disable |
禁止某项能力生效 | 更强调开关或能力被禁用,不一定要求此前处于 active 状态 |
delete |
删除对象或记录 | 关注对象消失,而不是状态切换 |
例如账户仍需保留历史记录,只是不允许继续使用时,deactivateAccount 通常比 deleteAccount 更准确。
最小例子
deactivateDevice 可以表示将一台已注册并处于活动状态的设备标记为非活动;设备记录仍存在,后续仍可能被重新激活。
常见误解是把 deactivate 当成所有“关闭”动作的通用词。只有当领域模型确实存在激活状态及其反向转换时,这个命名才最清晰。
表示资源、能力或服务当前可以使用,强调是否具备可用条件;适合 availableSlots、isAvailable 等状态或查询结果命名。
available
available 表示某个资源、能力或服务在当前条件下可以被使用、选择或分配,强调的是可用性,而不只是对象是否存在。
边界
available 通常依赖具体上下文:资源可能存在,但因为已被占用、未到开放时间、权限不足或服务异常而不可用。因此命名时应让读者能够判断“对谁、在什么条件下可用”。
布尔状态常使用 isAvailable;集合或数量则常见 availableSlots、availableWorkers 这类命名,用来表达当前可分配的对象。
与相邻词的区别
| 词 | 核心语义 | 常见区别 |
|---|---|---|
available |
当前可以使用或分配 | 强调满足使用条件 |
enabled |
某项能力被允许或开启 | 强调配置或开关状态 |
active |
对象正处于活动状态 | 强调生命周期或运行状态 |
free |
未被占用或无需付费 | 语义容易受上下文影响,不等同于一般意义的可用 |
例如一个功能可能已经 enabled,但其依赖服务异常时仍然不是 available;一台服务器也可能处于 active 状态,却因为容量已满而没有可用槽位。
最小例子
isAvailable 可以表示某个会议室当前满足预订条件;availableSlots 则表示当前仍可分配的名额数量。
常见误解是把 available 与“存在”画等号。判断是否适合这个词时,应核对代码表达的是“能否使用”,而不是“有没有这个对象”。