软件产品的文案分三层：界面上的按钮与提示、帮助中心的说明、开发者文档里的接口描述。同一个英文词在这三层里的中文写法往往不同，统一成一种反而会出问题。
界面文案：短、动词、可点击
按钮用动词，如 Save 译“保存”、Submit 译“提交”、Cancel 译“取消”，不加“请”。菜单项用名词，如 Settings 译“设置”、Billing 译“账单”。提示语说明后果而不是描述状态，例如“删除后不可恢复”比“该操作将执行删除”更有用。字数受限时优先保证动作明确。
帮助文档：解释概念而不是直译
deploy、provision、sync 这类词在用户文档里应写成用户能理解的动作：“发布到线上”“开通账号”“同步数据”。同一功能在界面与文档中的叫法必须一致，否则用户搜不到。首次出现专业词时给一句解释，不要假设读者懂行。
开发文档：保留英文或固定译名
- API、SDK、webhook 等通用缩写直接保留，不强行翻译。
- repository 译“仓库”，commit 译“提交”，branch 译“分支”，pull request 可视团队习惯保留英文。
- idempotent 译“幂等”，middleware 译“中间件”，按行业惯例。
- 代码、命令、参数名一律保留原文，只翻译解释性文字。
容易翻错的词
host 在云服务语境是“主机”，不是“主持人”；instance 是“实例”，不是“例子”；container 是“容器”，不要译“集装箱”；tenant 在多租户系统里是“租户”；deprecated 是“已弃用”，不是“已删除”。这些词一旦译错，开发者会直接误解行为。
术语一致性的落地方式
建立三层术语表：界面词、文档词、开发词，分别标注适用场景。翻译时按文档类型匹配，不要跨层套用。团队评审时把术语表作为验收项，比事后统一修改省力得多，方法见术语库与记忆库。
产品说明与帮助文档的本地化，还可参考商品详情本地化中的合规与表达规则。