Context Hub 技术指南：@babel/plugin-transform-shorthand-properties 对象字面量简写转换实战

@babel/plugin-transform-shorthand-properties是一个编译期 Babel 插件，用于在 JavaScript 构建阶段将 ES2015（ES6）对象字面量的简写属性（如{ name }）与简洁方法（如{ greet() {} }）展开为显式键值属性。本文以 Context Hub 仓库中维护的7.27.1版本文档为核心，完整覆盖安装、Babel 配置、CLI 与编程式调用方式，并结合仓库中的内容组织规范与 CLI 实现，说明如何通过chub获取并验证这类文档，读完即可在真实构建管线中落地该插件。

插件定位：一次纯编译期的语法展开

@babel/plugin-transform-shorthand-properties的核心职责只有一个：把对象字面量的简写语法改写为显式属性。以7.27.1为例，它同时处理两类 ES2015 写法：

• 简写属性（shorthand properties）：{ name }→{ name: name }
• 简洁方法（concise methods）：{ greet() {} }→{ greet: function() {} }

它是纯编译期插件，不涉及任何环境变量、鉴权步骤或运行时客户端初始化——插件安装并加入配置后，Babel 编译输出即被改写，无需额外的运行时依赖。

安装插件

插件以 npm 包形式发布，使用前需连同@babel/core一起安装。包将@babel/core声明为 peer dependency，因此两者必须同时安装：

npm install --save-dev @babel/core @babel/plugin-transform-shorthand-properties

如果从命令行运行 Babel，还需要一并安装 CLI：

npm install --save-dev @babel/cli @babel/core @babel/plugin-transform-shorthand-properties

将插件加入 Babel 配置

在babel.config.json或.babelrc.json中声明插件即可：

{ "plugins": ["@babel/plugin-transform-shorthand-properties"] }

在7.27.1版本中，该插件不暴露任何插件专属选项（plugin-specific options），因此将其加入plugins数组即完成全部配置。与同仓库维护的其他 Babel 插件（如 @babel/plugin-transform-arrow-functions 文档）不同，它没有spec之类的开关，也没有读取顶层assumptions的行为，配置路径更简单。

通过 CLI 执行转换

插件配置就绪后，可以用npx babel对目录或单文件执行转换。

转换整个源码目录：

npx babel src --out-dir lib --plugins @babel/plugin-transform-shorthand-properties

转换单个文件：

npx babel input.js --out-file output.js --plugins @babel/plugin-transform-shorthand-properties

两条命令都以--plugins显式指定插件，适合不想依赖配置文件或临时验证的场景；在实际项目中，更常见的做法是只写npx babel src --out-dir lib，让 Babel 自动读取babel.config.json中的插件声明。

在脚本、构建工具或测试辅助中编程式调用

当转换是脚本、构建工具或测试辅助程序的一部分时，可以直接使用@babel/core的transformSync编程式调用，绕过配置文件，仅启用当前插件：

import { transformSync } from "@babel/core"; const source = ` const name = "Ada"; const obj = { name, greet() { return "Hello, " + name + "!"; }, }; `; const result = transformSync(source, { configFile: false, babelrc: false, plugins: ["@babel/plugin-transform-shorthand-properties"], }); if (!result?.code) { throw new Error("Transform failed"); } console.log(result.code);

设置configFile: false与babelrc: false是为了确保本次转换只受传入的plugins控制，不受项目内其他 Babel 配置干扰——这在测试辅助程序中尤为常用。上述输入经转换后，输出形如：

const name = "Ada"; const obj = { name: name, greet: function () { return "Hello, " + name + "!"; }, };

注意：该插件只改写对象字面量语法，文件中的其他语法保持原样；若文件中还包含类、模块语法等需要转换的新语法，必须另外添加对应的 Babel 插件或预设。

插件实际重写的内容

以一组典型输入为例，插件同时覆盖简写属性与简洁方法两种形式：

const count = 1; const input = { count, increment(step) { return count + step; }, };

转换后，Babel 输出显式属性：

const count = 1; const input = { count: count, increment: function (step) { return count + step; }, };

在7.27.1的实现中，还有一个值得注意的细节：当简洁方法本身是 async 方法或 generator 方法时，Babel 将其转换为函数值属性后会保留async与*的语义行为——即{ async load() {} }会展开为async function值，{ *gen() {} }会展开为function*值，方法原有的异步与生成器特性不会因展开而丢失。

在 Context Hub 中获取本插件文档

本文档属于 Context Hub 仓库中按「作者 → 类型 → 条目 → 语言」组织的 Babel 文档集，路径为 plugin-transform-shorthand-properties/javascript/DOC.md，同目录下还维护了箭头函数、解构、模板字符串等一整套 Babel 转换插件文档（参见 content/babel/docs）。

对于编码 Agent 或开发者而言，使用chubCLI 即可直接检索并拉取该文档，无需在仓库中人工翻阅。先搜索：

chub search "babel shorthand properties" --json

命中后按 ID 获取，语言变体为 JavaScript：

chub get babel/plugin-transform-shorthand-properties --lang js

chub get会根据 ID 自动探测文档类型（doc 还是 skill），并在仅存在单一语言变体时自动推断语言；当存在多个语言变体而调用方未指定--lang时，CLI 会列出可选语言并提示补全（相关实现见 get.js）。搜索命令支持--tags、--lang、--limit等过滤参数，完整命令参考见 CLI Reference。

若希望 Agent 在编码前自动获取这类文档，可将 get-api-docs 技能 安装到 Agent 的技能目录，其标准流程为：运行chub --help获取最新指引 →chub search定位文档 →chub get <id> --lang js拉取内容 → 使用文档编写代码，并在发现文档未覆盖的细节时用chub annotate <id> "..."记录本地备注、用chub feedback <id> up|down反馈质量。

文档在仓库中的组织与元数据

Context Hub 的每份DOC.md都遵循统一的内容规范（详见 Content Guide）：多语言文档放在author/docs/entry-name/javascript/DOC.md这样的语言子目录中，文件头部使用 YAML frontmatter 声明元数据。本文档的 frontmatter 声明了name、description、metadata.languages: "javascript"、metadata.versions: "7.27.1"、metadata.source: maintainer与tags字段，其中versions指向 npm 上对应的包版本，source表示信任等级（official/maintainer/community）。这些 frontmatter 字段由 CLI 构建注册表时解析——仓库中的 frontmatter.js 实现了解析逻辑，会对---围栏内的 YAML 做严格校验并报告精确行号错误，chub build --validate-only可用于本地校验内容合法性而不实际构建。

重要陷阱与边界

• 该插件只改变构建输出，不做任何运行时 API 的 polyfill，也不会为浏览器补充新特性——它纯粹是语法层的展开。
• 它只重写对象字面量的简写属性与简洁方法。如果同一批文件还使用了其他新语法（如箭头函数、解构、模块语法），需要额外添加对应的 Babel 插件或预设；例如同仓库维护的 arrow-functions 插件文档、destructuring 插件文档 分别覆盖箭头函数与解构的转换。
• 如果构建后文件中仍然残留简写属性，应确认该文件确实被当前生效的 Babel 配置加载到了本插件——检查babel.config.json/.babelrc.json的plugins数组，以及是否因configFile: false、babelrc: false或目录级配置遮蔽导致插件未生效。

版本敏感说明

• 本文档目标版本为@babel/plugin-transform-shorthand-properties@7.27.1。
• 该版本不提供插件专属选项，配置即用；若使用其他版本，请以对应版本的发布说明为准。
• 插件的实际运行行为依赖整套 Babel 工具链（@babel/core的版本与解析器行为），支持矩阵应结合项目整体的 Babel 版本评估。