欢迎光临
我们一直在努力

Qwen Code 3 步全中文化:多语言配置与输出语言设置速查

Qwen Code 3 步全中文化:多语言配置与输出语言设置速查

【免费下载链接】qwen-code An open-source AI coding agent that lives in your terminal. 【免费下载链接】qwen-code 项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code

在中文环境下用 Qwen Code,最常见的挫败是:界面还是英文,模型回答也是英文。这篇用 3 条命令完成 Qwen Code 中文配置——界面立刻中文化,模型输出也能钉死为中文,全程不离开终端。

先说结论:界面语言和输出语言是两把独立的开关

UI 语言只决定菜单、命令提示用什么语言显示;输出语言决定模型用什么语言回答。前者存在 ~/.qwen/settings.json,后者写进独立的规则文件 ~/.qwen/output-language.md,两者互不带动。所以只切界面、不切输出,模型依旧回你英文,这是设计如此,不是 bug。

从打开终端到中文界面,3 条命令就够

第一步,看当前状态:

/language

不带参数运行会打印当前 UI 语言和 LLM 输出语言两行。已经都是中文就跳过后面两步。

第二步,切界面:

/language ui zh-CN

支持 9 个选项:en-US、zh-CN、zh-TW、ru-RU、de-DE、ja-JP、pt-BR、fr-FR、ca-ES。也可以只敲别名,/language ui zh 等价;设置立即生效并写入用户级 settings.json。

第三步,钉死模型输出:

/language output 中文

命令会把规则写入 ~/.qwen/output-language.md,同时刷新当前会话的系统指令——下一条消息起模型就用中文回答,不用重启会话,已有对话历史也保留。

收尾再敲一次 /language 确认两行都是中文即可。如果你更习惯图形界面,/settings 里的 General → Language 也能改 UI 语言,效果相同。

切换背后发生了什么:语言文件的三个存放位置 🌏

打个比方。内置翻译文件是"标准词表":packages/cli/src/i18n/locales/ 下每种语言一个文件(zh.js、en.js 等),代码里的文案以 key 存英文原文,t() 函数拿 key 查表换字符串。/language ui 做的事就是换一本词表,并重新注册所有命令描述,让命令提示也跟随新语言刷新。

规则文件 output-language.md 则像"贴在模型桌角的便签":内容是一句"你必须始终用中文回答",文件里还有一个 HTML 注释标记记录当前语言,程序靠它识别文件状态。便签分两种文案——auto 模式写"跟随用户输入语言",固定模式写"无论输入什么都用中文回答",但代码块、命令、报错栈明确要求原样保留,不许翻译。

第三个位置是 ~/.qwen/locales/。放一个同名 .js 文件进去就是自定义词表,加载时优先于内置翻译文件,适合本地临时修正个别措辞。

少有人知的进阶用法:–project 作用域与 QWEN_CODE_LANG

第一个是作用域标志。/language ui zh-CN –project 把语言写进当前工作区设置,只对这个仓库生效,团队协作时不用强加个人偏好;–global 则显式写用户级设置。两个标志不能同时用。注意 –project 要求工作区已被信任,否则会直接拒绝,先 /trust 再试即可。

第二个是环境变量。首次启动时 Qwen Code 按 QWEN_CODE_LANG → LANG → 系统 locale 的顺序决定默认语言,都失败则回退英文。CI 或无头脚本里在命令前加一行:

export QWEN_CODE_LANG=zh

就能让非交互运行也拿到中文界面,不必依赖任何斜杠命令。

踩坑速查:3 个高频问题各配一行修复

命令提示仍是英文:命令元数据在注册时解析过,手改 settings.json 后没有重新加载。重跑 /language ui zh-CN 触发命令重注册,或重启会话。

设置了 /language output 模型仍回英文:规则文件此前被手动编辑过,与 settings 里的值脱节。重跑 /language output 中文,让程序整体重写文件并刷新会话。

界面中文显示成乱码:通常是终端 locale 不是 UTF-8 而非语言包问题。确认 echo $LANG,补上 export LANG=zh_CN.UTF-8 后重开终端。

想挖源码,从这里入手

多语言支持的核心在 packages/cli/src/i18n/:languages.ts 定义 9 种语言与别名解析,index.ts 负责词表加载和 t() 查表,languageUtils.ts 负责规则文件的生成与 auto/固定语言迁移。命令侧逻辑在 languageCommand.ts。用户文档见 docs/users/features/language.md。

现在打开终端敲一条 /language ui zh-CN,三十秒后你就能看到本文这套 Qwen Code 多语言配置的实际效果。

【免费下载链接】qwen-code An open-source AI coding agent that lives in your terminal. 【免费下载链接】qwen-code 项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

赞(0)
未经允许不得转载:171主机测评 » Qwen Code 3 步全中文化:多语言配置与输出语言设置速查
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址