在 Cursor 中使用 globalize.now
一条命令，即可为 Cursor 构建的应用提取字符串并生成语言文件。
Cursor 生成可用的 UI 很快，但通常会把英文直接硬编码在 JSX 里。globalize.now 会提取这些硬编码字符串、生成翻译键并创建语言文件，把 Cursor 构建的应用变成可直接翻译的代码库。配置只需一条命令，之后每次 Git 推送都会自动同步。
前提条件
- 一个用 Cursor 构建的项目
- 一个 Git 仓库
- Node.js 18+
- 已安装任意 JavaScript i18n 库（i18next、next-intl 等），全新项目则无需安装
如何在 Cursor 中配置 globalize.now
打开 Cursor 项目并确认 Git
在 Cursor 中打开仓库，确认代码已提交并推送到 Git 远程仓库，这样后续的推送才能触发同步。
在项目根目录运行 Skills 安装命令
在 globalize.now 上连接仓库，即可在应用内完成转换；也可以在仓库根目录的终端中安装 Globalize Agent Skills，让助手搭建 i18n 并扫描整个代码树。
npx skills add globalize-now/globalize-skills --all让 Agent 分析代码库
按照 Agent 的提示操作，让它在组件和路由中找出所有用户可见的硬编码字符串。
检查建议的翻译键结构
在任何重构合入分支之前，先检查建议的键结构和命名。
确认提取结果和语言文件
确认变更后，系统会生成翻译键，组件改为调用运行时 i18n API 而不是字面量，语言文件也会写入仓库。
提交并推送
提交变更并推送到默认分支，之后的 Git 推送会让 globalize.now 持续同步新增字符串。
通过 MCP 连接（可选）
想直接在 Cursor 中操作 Globalize？代码完成 i18n 改造后，连接 MCP 即可。
添加到 ~/.cursor/mcp.json
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}更多：连接 MCP →
常见问题
Cursor 不断新增硬编码字符串
解决方法： globalize.now 在每次 Git 推送时运行，新的字面量会被自动捕获，不会在两次发布之间悄悄堆积。
翻译键与现有 i18n 配置冲突
解决方法： globalize.now 会检测已有的 i18n 库并遵循其约定，新键会扩展现有翻译目录，而不是与之冲突。
常见问题解答
globalize.now 适用于任何由 Cursor 生成的项目吗？
适用，只要技术栈在 globalize.now 的 Agent Skills 支持范围内（Next.js、React、Vue 等现代 JavaScript 框架）。globalize.now 关注的是提取硬编码 UI 字符串、生成翻译键和语言文件，与 JSX 由哪个编辑器生成无关。你仍需在项目根目录运行 npx skills add globalize-now/globalize-skills，并按引导提示操作，Agent 才能扫描仓库并提交可合并的 diff。
我需要配置 globalize.now 来识别 Cursor 特有的代码模式吗？
无需单独的 Cursor 集成。无论文件是手写的还是由 Cursor 生成的，globalize.now 分析仓库的方式都一样。Skill 会查找用户可见的字面量和路由结构，再按你采用的 i18n 库提出匹配的键。你可以像审查其他改动一样，在 Git 中审查这份方案。
已经做了部分 i18n 的 Cursor 项目，还能用 globalize.now 吗？
可以。当键和语言文件已经存在时，这套工具会在现有目录基础上扩展。globalize.now 会检测你使用的运行时库，只提出新增内容，不会丢弃已有成果，所以你可以逐步完成字面量的迁移。继续用 Git 推送，新增的 UI 就始终在覆盖范围内。
在 Cursor 项目中，globalize.now 的输出能搭配哪些 i18n 库？
globalize.now 与具体库无关：它生成结构化的键和语言文件，可搭配 i18next、next-intl、react-intl、Lingui、vue-i18n 等常见运行时库。Cursor 项目沿用你选定的技术栈，globalize.now 负责提取和同步。Agent Skill 还会帮你接好框架所需的 provider 或中间件。
globalize.now 会修改 Cursor 生成的组件吗？
globalize.now 会改写调用处，让字面量统一走你的 i18n API（例如 t() 或消息组件），同时保持原有行为。合并前你可以在 Git 中查看 diff，就像审查 Cursor 生成的其他改动一样。首次合并之后，后续推送会自动同步新增字符串，无需单独的导出步骤。
在 Cursor 里该在哪里运行 globalize.now？
始终在仓库根目录下运行 npx skills add globalize-now/globalize-skills，可以用 Cursor 的集成终端，也可以用任何指向该根目录的 shell。Skill 的作用范围限定在当前项目，会安装本地化 Skill 包，然后把控制权交还给 Agent 处理后续提示。留在根目录能让路径检测与 CLI 扫描目录树的方式保持一致。
在 Cursor 中试用 globalize.now
从项目根目录开始：
npx skills add globalize-now/globalize-skills --all