故障排除

在使用 i1n 命令行工具、SDK 和仪表板时，常见错误和问题的解决方案。

i1n：未找到命令

此错误表示 i1n CLI 未全局安装或不在您的 PATH 中。运行 npm install -g i1n 进行安装。如果您使用版本管理器（nvm、fnm），请确保全局 bin 目录在您的 PATH 中。

在 macOS/Linux 上，您可以使用 which i1n 来验证安装路径。如果使用 bun，请改用 bun install -g i1n。

当 i1n.config.json 中的 API 密钥丢失、过期或无效时，就会发生这种情况。请在 dashboard.i1n.ai 的组织设置中生成新密钥，然后运行 i1n init 进行重新配置。

请确保您使用的是拥有该项目的组织的正确 API 密钥。每个组织都有自己的密钥 — 一个组织的密钥无法访问另一个组织的aught项目。

如果 i1n push 报告零键或跳过文件，请验证您的 locales 目录和文件格式是否与 i1n.config.json 中的配置匹配。如有必要，请运行 i1n init 重新配置。

常见原因包括 glob 模式不正确、文件格式不匹配（例如，配置为嵌套 JSON 时却使用了扁平 JSON）或翻译文件为空。

这通常意味着项目在服务器上没有翻译。请先运行 i1n push 上传您的源密钥，然后运行 i1n pull 下载翻译。

如果您已推送键但拉取返回空文件，请检查是否已通过 i1n add-language 或通过仪表板将目标语言添加到了您的项目中。

如果在拉取后 IDE 显示错误，请确保 i1n.d.ts 已包含在您的 TypeScript 编译中。CLI 会自动更新 tsconfig.json，但手动配置可能需要调整。

切勿直接修改 i1n.d.ts — 它会在每次 i1n pull 时重新生成。如果文件看起来已损坏，请删除它并再次运行 i1n pull。