Codex插件市场汉化全攻略：CLI、IDE、Web端一站式设置

Codex 插件市场默认全是英文，第一次打开的时候满屏的 Plugin、Marketplace、Install、Dependency，看着确实有点头疼。我最早也以为得找个汉化补丁，后来折腾了几轮才明白，这事儿根本没那么麻烦——关键是要搞清楚你用的到底是哪个入口，以及你真正想汉化的那一层是界面还是插件描述。这篇就把我实际试过的几条路子都捋一遍，从命令行到 IDE 再到网页版，每一步都给到可以直接照抄的做法。

1. 先搞清楚：你说的“用中文看”是哪个层级

1.1 界面语言、插件描述、文档是三层不同的事

很多朋友折腾半天没成功，原因是把“界面”和“内容”混在一起了。Codex 插件市场至少有三层东西，每一层的汉化方式完全不同：

• 界面文字：菜单、按钮、标签这类程序自己生成的文字，比如 Search、Install、Installed、Version。这些走的是程序的国际化机制，改配置或者装语言包就能变。
• 插件描述：每个插件页面里的介绍、特性列表、使用说明，这些是插件作者自己写的文字，不跟随界面语言包。界面切成中文，插件描述照样是英文。
• 文档与评论区：官方文档和用户反馈更不可能被界面语言影响，只能靠翻译工具或自己阅读。

这三层分开理解之后，你才能判断自己到底卡在哪一层。如果你只是想让按钮和导航变中文，配置 locale 就行；如果你是看不懂插件是干嘛的，那就算界面全中文，描述不变你也照样看不懂。所以我在下文给的是组合方案，不是单点方案。

1.2 三种常见使用环境，对应不同汉化路径

Codex 插件市场的入口至少分成三类，每一类的处理思路都不一样：

• 命令行 CLI 版：插件市场以终端输出或交互式界面呈现。汉化路径是给 Codex 配置语言环境，同时确保终端支持中文显示。
• IDE 集成版：比如 VS Code、JetBrains 里的 Codex 插件面板，市场入口通常嵌在 IDE 的扩展窗口里。汉化路径是直接切换 IDE 的界面语言，插件市场会跟着变。
• Web 版目录：如果是在浏览器里打开的插件市场网页，最简单的办法是浏览器翻译，没有之一。

我自己现在的工作流是三层同时处理：CLI 配置 locale，IDE 装中文语言包，网页版用浏览器翻译，插件描述实在看不懂就贴给 AI 让它整理中文要点。这套组合基本覆盖了所有场景。

2. 方案选型：为什么不要一上来就找“汉化补丁”

2.1 优先走官方国际化配置，省心且不容易踩坑

程序界面语言这件事，正规工具都会走一套叫 i18n（国际化）的机制。简单说，程序会把界面上的文字做成语言条目，再根据你的环境设置决定显示哪种语言。Codex 这类工具也不例外，通常支持通过配置文件或环境变量来指定语言。

我强烈建议优先走这条路线，原因有三个：

• 升级不失效：官方语言机制会跟着版本迭代持续维护，第三方汉化补丁可能一升级就废了。
• 安全性有保障：汉化补丁本质上是要修改程序资源文件，来源不明的话风险很大，没必要为了一点翻译去承担这种不确定性。
• 排查简单：配置不对最多是不生效，不会把整个程序搞坏。

程序里常见的语言设置优先级一般是：命令行参数 > 环境变量 > 配置文件。也就是说，如果你同时设置了环境变量和配置项，环境变量通常会优先生效。这一点在你排查“为什么改了配置没反应”时很有用。

2.2 第三方汉化和翻译工具的取舍

第三方方案不是不能用，但要分清场景。浏览器翻译插件只对网页有效，对命令行界面完全无效；汉化包对特定版本有效，但可能滞后；字典和速查表虽然笨，但永远不过时。

我的取舍标准很简单：

• 界面文字能官方配置就官方配置，不折腾任何补丁。
• Web 页面用浏览器自带翻译，不额外装乱七八糟的插件。
• 非看不可的英文描述，用速查表加 AI 辅助理解，而不是强行追求全中文。

2.3 我的选择：按场景分层处理

这套“分层处理”的思路是我踩过坑才总结出来的。最早我试图找一个“整体汉化”的方案，结果发现 CLI 版、IDE 版、Web 版根本不是一个东西，统一方案不存在。老老实实按照前面说的三层去处理，反而每一步都很快。

具体落地就是：

• 命令行版：改~/.codex/config.toml，配置 locale。
• 环境变量：在 shell 里导出一个LANG或LANGUAGE，给整个环境兜底。
• IDE 版：VS Code 装中文语言包，JetBrains 在设置里切语言。
• Web 版：浏览器右键翻译。
• 描述内容：速查表加 AI 翻译。

这套方案看起来散，但每条都是最简单的做法，组合起来就是全覆盖。

3. 实操：命令行版 Codex 插件市场如何切中文

3.1 找到配置文件：路径与备份

命令行版的 Codex，配置文件一般在用户目录下的.codex文件夹里，Linux 和 macOS 是~/.codex/config.toml，Windows 是%USERPROFILE%\.codex\config.toml。不同发行版或者不同版本可能有差异，但大方向不变，先打开这个目录看一眼。

动手之前务必先备份：

cp ~/.codex/config.toml ~/.codex/config.toml.bak

这一步看着多余，实际太有必要了。我遇到过配置被自己改乱的情况，没有备份就只能凭记忆恢复。备份完之后，用cat ~/.codex/config.toml看一下文件当前内容，确认里面有哪些配置段，再决定往哪里加内容。

3.2 修改 locale 的建议写法

在配置文件里加上语言设置，常见写法是增加 locale 相关配置段。以通用做法为例，可以这样写：

[locale] language = "zh-CN"

如果你不想动配置文件，也可以用环境变量的方式。在 Linux 和 macOS 的 shell 里执行：

export LANG=zh_CN.UTF-8 export LANGUAGE=zh_CN.UTF-8

Windows 的 PowerShell 里可以执行：

$env:LANG = "zh_CN.UTF-8"

提示：环境变量的方式对会话内所有程序生效，适合临时测试。弄明白了再写进配置文件，这样每次启动都自动生效。

有一点必须强调：zh_CN.UTF-8这个值需要你的系统里有对应的语言环境。Linux 上可以先执行locale -a看看列表里有没有zh_CN.utf8，没有的话要先装语言包，否则设置不生效。这一步我实测最容易漏，很多人改了配置没反应，最后发现是系统压根没有中文本地化支持。

3.3 验证是否生效

改完配置，重启 Codex，然后输入插件市场相关的命令，比如：

codex plugin list

或者：

codex plugin search codex

正常的话，界面上的功能按钮和提示文字会变成中文，比如“已安装”“搜索”“版本”这类。插件本身的名称和作者名不会变，那是插件作者自己定的，不属于界面语言。

我实际测试下来的体验是：配置生效后，正常情况下命令的输出结构会保留英文术语，比如Plugin ID、Status这些字段名未必全翻译，但说明文案和提示语会明显中文化。不要指望百分之百全覆盖，这不现实，也不必要。

4. 实操：IDE 与 Web 端怎么看中文

4.1 VS Code 系列：装中文语言包之后的变化

VS Code 本身支持多语言界面，先安装官方中文语言包。打开扩展面板，搜索 “Chinese Language Pack”，安装 Microsoft 出的那个，然后按提示重启。

装好中文语言包后，Codex 插件的市场页面会跟随 VS Code 的界面对话。这里有三个细节值得注意：

• 中文语言包影响的是 IDE 的界面框架，Codex 插件的自绘界面未必全部跟随。插件内部如果用了自己的网页界面，语言可能还是英文。
• 插件市场的“市场”标签页，本质上是在 IDE 里嵌入的 Web 内容，翻译程度取决于内容来源。
• 如果插件面板里的描述还是英文，回到第 1 章说的分层逻辑——那是内容层，不是界面层。

实际操作中，VS Code 里查看插件市场，中文语言包能解决七八成的界面文字，剩下的靠页面内右键翻译解决。

4.2 JetBrains 系列：界面语言与插件面板

JetBrains 系的做法更直接。打开 Settings，找到 Appearance & Behavior，点 Appearance，在 System Language 那里选中文，然后重启 IDE。

重启之后，整个 IDE 界面包括插件市场入口都会变成中文。JetBrains 的插件市场本身就是 IDE 的一部分，所以跟随得很好，比 VS Code 还要省事。唯一要注意的是，某些专业插件是独立的工具窗口，界面文字由插件自己控制，IDE 语言切换对它们无效。这种情况就只能看插件自身支不支持多语言了。

4.3 Web 版插件市场：浏览器翻译的正确打开方式

如果 Codex 插件市场有网页版，浏览器翻译是最快的方式。Edge 和 Chrome 都在地址栏右侧有翻译按钮，点击之后整页自动翻译。Firefox 需要先安装官方翻译扩展。

浏览器翻译有个细节容易坑人：翻译后的页面搜索功能可能打折扣。比如你在翻译后的页面搜索代码生成，可能翻不出英文的code generation。建议搜索时切回原文，或者直接用英文关键词搜，搜到结果再切回中文阅读。

另外，浏览器翻译是“视图层面”的翻译，不改动网站原始内容。刷新页面后翻译会消失，需要重新翻译，这个不是故障，是机制如此。

5. 插件描述看不懂怎么办：我的阅读套路

5.1 英文技术描述的几个高频词块

界面汉化之后，插件描述才是真正的拦路虎。我帮不少朋友排查过，发现大部分人不是不认识单词，而是不熟悉插件描述里反复出现的“功能块”结构。英文插件描述通常按这几块组织：

• Features / What’s new：插件功能列表，对应这个插件能干什么。
• Installation / Getting started：安装和起步步骤。
• Configuration / Options：配置项说明，通常带表格或代码示例。
• Requirements / Dependencies：依赖项、运行环境要求。
• License / Disclaimers：许可协议和免责声明。

当你看到一段英文描述，先判断它在讲哪一块，再去看细节，压力会小很多。想快速抓重点，就看 Features 和 Requirements，一个告诉你它有什么用，一个告诉你你能不能装。

5.2 20 个插件市场高频术语速查表

下面是我整理的一份速查表，覆盖插件市场里出现频率最高的术语。我实际用过，能解决绝大多数阅读问题。

英文术语	中文含义	出现场景
Plugin / Extension	插件	市场条目名称
Marketplace / Registry	插件市场 / 插件仓库	顶部导航
Install	安装	操作按钮
Uninstall / Remove	卸载 / 移除	操作按钮
Enable / Disable	启用 / 禁用	插件管理页
Installed	已安装	状态标签
Update	更新	版本相关
Version	版本	版本信息
Author / Publisher	作者 / 发布者	插件信息区
Downloads	下载次数	热度指标
Stars / Rating	星标 / 评分	用户评价
Runtime	运行时环境	依赖说明
Dependency	依赖项	安装要求
Manifest	插件清单文件	配置文件
Permission	权限	安全提示
Token	访问令牌	鉴权配置
Endpoint	接口地址	服务配置
MCP Server	MCP 服务端	模型上下文协议服务
Changelog	更新日志	版本记录
Repository	源代码仓库	项目主页

这 20 个词认熟之后，插件市场基本的界面和描述都能看懂大半。我不主张背单词表，但这份小表可以存下来，遇到不认识就翻一下，用两次就熟了。

5.3 用 AI 辅助翻译插件说明的实操

实在看不懂的时候，直接请 AI 帮忙。最常见的做法是把插件描述或者 README 整段复制给 AI，然后让它输出中文要点。我常用的提问方式很简单：

请帮我翻译这段插件说明，并整理成：1. 这个插件有什么功能；2. 安装步骤；3. 需要什么配置；4. 有什么注意坑。

这个 prompt 为什么有效？因为它不是让 AI 逐字翻译，而是让 AI 提取结构化的信息。插件说明本来就结构分明，用这种方式拿到的结果，比一整段中文译文好读得多。

还有一个进阶技巧：如果把插件界面截图发给 AI，让它根据截图识别界面文字并说明每个按钮的作用，效果也很好。这不是什么高深操作，就是让 AI 帮你把英文界面变成“带注释的中文说明图”，尤其适合配置界面复杂的插件。

6. 常见问题与排查实录

6.1 改了配置文件没反应

这是问得最多的问题。按优先级排查：

1. 确认你改的是不是正确的配置文件。可以用codex --version或者codex --help看有没有输出配置文件路径的命令。
2. 确认配置语法正确。TOML 格式要求缩进和键值写法严格，多了个空格都可能解析失败。
3. 确认程序是否完全重启。CLI 程序一般启动时读取配置，不重启不会重新加载。
4. 确认系统语言环境存在。执行locale -a看列表里有没有中文项。
5. 确认有没有其他配置覆盖了你的设置。环境变量的优先级通常高于配置文件，检查 shell 配置里有没有导出过相关变量。

我遇到过一次最诡异的排查：配置写对了，系统也支持中文，但就是不生效。最后发现是 shell 启动脚本里有一个export LANG=en_US.UTF-8，把配置文件的设置覆盖了。环境变量优先级更高，所以配置文件一直没机会生效。

6.2 中文乱码怎么处理

中文显示了但全是方块或者问号，是终端编码问题，不是 Codex 的问题。排查顺序：

• 确认系统 locale 是 UTF-8：locale命令查看。
• Windows 终端里执行chcp 65001切到 UTF-8 代码页。
• 确认终端字体支持中文。Windows 的默认终端字体换成“等线”或“微软雅黑”能解决大部分方块字问题。

乱码问题比较隐蔽的地方在于，你的系统可能默认是C.UTF-8或en_US.UTF-8，这种情况下中文字符集没加载完全，输出里偶尔会出现个别字符显示异常。直接在~/.bashrc或~/.zshrc里加上export LANG=zh_CN.UTF-8是最彻底的解决办法。

6.3 插件名、作者名还是英文，属不属于没汉化成功

不属于。插件名、作者名、插件 ID 这类信息来自插件本身的元数据，不是界面语言的一部分。就像你给一个外国人起中文外号，但身份证上的名字不可能跟着变。判断汉化是否成功，看的是功能区文字、状态提示、说明文案，不是看插件名。

6.4 更新后配置被覆盖

Codex 更新或安装新插件后，配置文件偶尔会被重置或合并出问题。这就是我为什么在第 3 章强调备份。更稳的做法是把语言设置放在环境变量里，而不是配置文件里。环境变量独立于配置文件，更新程序时不会被触碰，稳定性反而更高。

如果你已经出现配置被覆盖的情况，把备份文件恢复一下就行：

cp ~/.codex/config.toml.bak ~/.codex/config.toml

恢复之后确认备份文件里的内容是不是你原来的完整配置，别把一个旧版本直接覆盖到现在的新版本上。

最后分享一个小技巧

我个人在实际使用中最顺手的一套组合，是在 shell 配置里固定导出LANG=zh_CN.UTF-8，这样所有跟 Codex 相关的命令行工具都自动中文显示，不需要每个工具单独配置。IDE 那边只装一次语言包，之后一劳永逸。网页版和描述阅读就看速查表。这套方案我用了很久，没翻过车。你与其到处找汉化补丁，不如花十分钟把这几件事配置好，以后打开插件市场就再也不用对着英文页面发愣了。