📥 安装指南
一、前置要求
在安装前，请确保：
- VS Code 版本 ≥ 1.89.0
- 项目中有可访问的语言文件目录（常见如
locales/、i18n/）
二、安装方式
✅ 方式一：通过扩展市场安装
VS Code Marketplace
- 打开 VS Code
- 打开扩展面板（快捷键：
Ctrl+Shift+X/Cmd+Shift+X） - 搜索
i18n Mage - 点击 安装 或访问 Visual Studio Marketplace 页面
OpenVSX 平台（适用于 VSCodium、Cursor 等）
- 打开编辑器扩展面板
- 搜索
i18n Mage - 点击 安装 或访问 OpenVSX 页面
💻 方式二：通过命令行安装
从 VS Code Marketplace 安装
bash
code --install-extension jensen-wen.i18n-mage从 OpenVSX Registry 安装
bash
code --install-extension jensen-wen.i18n-mage --registry https://open-vsx.org三、平台兼容与更新
| 平台 | 适用编辑器 | 更新频率 | 自动更新 |
|---|---|---|---|
| VS Code Marketplace | Visual Studio Code、VS Code Insiders | 实时同步 | ✅ 支持 |
| OpenVSX Registry | VSCodium、Cursor 等开源编辑器 | 与 Marketplace 同步 | ⚙️ 取决于编辑器 |
四、验证安装是否成功
安装成功后，你应能看到以下变化：
- 活动栏图标：出现巫师帽 🧙♂️ 图标
- 命令面板：
Ctrl+Shift+P可搜索到 i18n Mage 命令 - 侧边栏视图：可打开
i18n Mage / Grimoire面板
快速验证命令
打开命令面板（Ctrl+Shift+P），输入以下命令以测试：
i18n Mage: Check Usage：检测词条使用情况i18n Mage: Search：搜索词条i18n Mage: Fix：执行修复流程
五、安装问题排查
如果安装失败或功能异常，可尝试以下步骤：
- 重启编辑器
- 检查版本：确认 VS Code ≥ 1.89.0
- 检查路径配置：确认已配置语言目录（
i18n-mage.workspace.languagePath） - 查看日志：打开“输出”面板，选择“i18n Mage”
- 开启调试日志：临时启用
i18n-mage.general.enableDebugLog后重试 - 反馈问题：在 GitHub 提交 Issue