Qwen Code 3 步全中文化:多语言配置与输出语言设置速查
【免费下载链接】qwen-code An open-source AI coding agent that lives in your terminal. 项目地址: 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. 项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考





