Jan 多语言界面完整指南：3 步切换 17 种语言，告别英文界面
【免费下载链接】janJan is an open source alternative to ChatGPT that runs 100% offline on your computer.项目地址: https://gitcode.com/GitHub_Trending/ja/jan
给同事演示 Jan 的离线 AI 能力，对方盯着满屏英文按钮一脸茫然；或者你刚装好 Jan，菜单里全是 Settings、Downloads，想改成中文却不知从哪下手。语言界面不顺手，会直接影响你每天使用这台本地 AI 助手的效率。Jan 内置了完整的界面多语言支持，17 种语言一键切换、即时生效，下文带你 5 分钟把它用起来。
60 秒快速上手：切换 Jan 界面语言的 3 个步骤
- 打开 Jan，点击主界面的设置入口，进入"设置"页面。
- 在左侧找到"通用"（General）选项卡，页面里有一行"语言"（Language）。
- 点击右边的语言下拉框，选择目标语言，比如"简体中文"。
点击后界面上的菜单、按钮、提示文字会立刻变为你选的语言，无需重启应用。因为语言偏好会被自动保存到本地，下次打开 Jan 时仍是你上次选的语言，不会跳回英文。
能做什么：Jan 支持哪些界面语言
Jan 当前的语言选择器内置了 17 种语言，覆盖中英文、日韩、欧洲主流语言：
- 中文：简体中文（zh-CN）、繁体中文（zh-TW）
- 亚洲：日语、韩语、越南语、印尼语、印地语
- 欧洲：英语、西班牙语、法语、意大利语、德语、波兰语、捷克语、葡萄牙语（巴西）、俄语、加泰罗尼亚语
选择器里每项都显示该语言的自称（如 Português (Brasil)、日本語），所以即使你现在界面是英文，也能准确找到自己的目标语言。
怎么配置：语言偏好是如何生效和保存的
整个机制拆开看很简单：
- 翻译内容：全部放在 web-app/src/locales/ 目录下，每种语言一个子目录（如
zh-CN/、ja/），里面按功能模块拆成 15 个 JSON 文件（common.json、chat.json、settings.json等）。界面显示的每一处文字，都是从这些文件里按键取出来的。 - 切换逻辑：由 LanguageSwitcher.tsx 这个小组件实现，它负责列出语言并触发切换。
- 保存位置：你选的语言会被写入本地设置存储（见 useGeneralSetting.ts），启动时自动读回，所以偏好能跨会话保持，默认语言是英文。
- 回退机制：如果某个界面文字在你所选语言里还没有翻译，Jan 会自动回退显示英文，不会显示乱码或空白。
理解"回退"这一点很关键：它决定了你能看到英文残留的原因（下一节细讲）。
怎么调优：想让翻译更完善，从这里入手
如果你是开发者或某国语言的贡献者，Jan 提供了现成的检查工具。在项目根目录运行：
node scripts/find-missing-translations.js这一行命令会拿英文翻译文件当基准，逐键比对其余所有语言，列出每种语言缺了哪些词条（scripts/find-missing-translations.js）。你只需照着清单，在对应语言的 JSON 文件里把缺的键值补上即可，比如往web-app/src/locales/zh-CN/chat.json里添加缺失的键。补完再跑一次脚本确认，就可以提 Pull Request 了。贡献流程可参考 CONTRIBUTING.md。
避坑实录
现象：切换成中文后，个别按钮或提示仍显示英文。原因：该词条在中文翻译文件里还没被翻译，Jan 的回退机制自动显示了英文。 解决：去 web-app/src/locales/zh-CN/ 下找到对应模块的 JSON，确认键是否存在；缺失的话，按上一节的方法补上翻译。
现象：界面上出现了类似common:settings这样的英文字符串。原因：翻译键完全找不到时，Jan 会把键名本身当作文案显示出来（通常出现在刚改过翻译文件之后）。 解决：检查 JSON 是否写坏了结构、键名是否与英文基准文件一致，修正后重启应用重新加载即可。
现象：换了台电脑或重置数据后，语言又变回英文。原因：语言偏好是随本地设置一起保存的，换机或清数据后偏好丢失，于是回到默认的en。 解决：按"60 秒快速上手"的 3 步重新选一次语言，之后偏好会再次被记住。
下一步行动
- 浏览完整功能与安装说明：docs/
- 想贡献新语言或补翻译：先跑
node scripts/find-missing-translations.js看看缺口，再从 web-app/src/locales/ 下手 - 进阶玩法：切换不同语言后对比同一功能的措辞，挑出你觉得翻译不够地道的词条，直接改 JSON 并提 PR
【免费下载链接】janJan is an open source alternative to ChatGPT that runs 100% offline on your computer.项目地址: https://gitcode.com/GitHub_Trending/ja/jan
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
