对象字面量简写需以变量名自带清晰语义为前提，禁止无上下文裸简写；应避免参数解构后直接简写、用展开运算符显式组合配置、关键入口点用计算属性名固化，并通过检查清单和eslint规则保障可维护性。
对象字面量简写（如 { timeout, method }）本身简洁高效，但滥用会显著抬高团队协作中的理解门槛——尤其当变量来源模糊、命名意图不清、或与上下文脱节时，阅读者需反复跳转查找变量定义，甚至误判字段含义。防范关键不在禁用简写，而在建立“何时可用、如何可控”的共识机制。
变量名必须自带语义，禁止无上下文裸简写
简写成立的前提是变量名本身已明确表达用途和约束。例如 const maxRetries = 3 → { maxRetries } 是安全的；而 const r = 5 → { r } 则不可接受。团队应约定：所有用于简写的变量，命名须满足“不看声明、仅凭键名就能推断其类型、单位和业务含义”。
- ✅ 推荐：
const apiTimeoutMs = 10000→{ apiTimeoutMs } - ❌ 禁止：
const t = 10000→{ t }（t 是 time？type？token？） - ⚠️ 特别注意：避免在函数参数解构后直接简写，如
function req({ url, method }) { return fetch(url, { url, method }); }—— 这里url在 fetch 配置中非法，且掩盖了实际意图
配置对象优先用展开运算符 + 显式键控
动态组合配置（如请求选项、UI 组件 props、插件参数）极易因简写丢失过滤逻辑和字段语义。此时应放弃简写，改用展开语法明确声明“哪些字段参与、哪些被忽略、哪些有默认值”。
- 用
{ ...baseConfig, method: 'POST', headers }替代{ baseConfig, method, headers }，避免嵌套结构误导 - 对可选字段做显式判断：
{ ...(timeout !== undefined && { timeout }), ...(headers && { headers }) }，让逻辑可见 - 关键入口点（如插件 hooks、Schema 字段名）必须用计算属性名固化：
{ ["validate"]: function validate() { ... } }，防止压缩或重构误删
建立简写使用检查清单并融入 Code Review
把简写是否合理转化为可执行的审查项，而非依赖个人经验。在 PR 模板中加入以下必查条目：
- ✅ 所有简写变量已在当前作用域明确定义，且命名符合语义规范
- ✅ 无变量值为
undefined或null却被无条件简写进对象（避免生成无效字段） - ✅ 未将函数参数解构结果直接简写进外部 API 调用对象（如 fetch、axios）
- ✅ 配置对象中不存在与目标 API 不兼容的字段（如向
fetch()传url）
用工具辅助识别高风险简写模式
借助 ESLint 插件提前拦截典型问题。推荐启用以下规则：
-
no-unused-vars：防止声明了却未使用的变量被误简写 -
no-undef：杜绝未声明变量进入简写导致运行时报错 - 自定义规则检测“参数解构后直接简写”模式，例如匹配
function f({ a, b }) { return { a, b }; }并提示潜在风险 - 在 CI 流程中对构建产物做字符串扫描，确认关键配置键名（如
"timeout"、"retry"）是否完整保留
