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 配置 localeIDE 装中文语言包网页版用浏览器翻译插件描述实在看不懂就贴给 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.tomlWindows 是%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 LANGzh_CN.UTF-8 export LANGUAGEzh_CN.UTF-8Windows 的 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 ServerMCP 服务端模型上下文协议服务Changelog更新日志版本记录Repository源代码仓库项目主页这 20 个词认熟之后插件市场基本的界面和描述都能看懂大半。我不主张背单词表但这份小表可以存下来遇到不认识就翻一下用两次就熟了。5.3 用 AI 辅助翻译插件说明的实操实在看不懂的时候直接请 AI 帮忙。最常见的做法是把插件描述或者 README 整段复制给 AI然后让它输出中文要点。我常用的提问方式很简单请帮我翻译这段插件说明并整理成1. 这个插件有什么功能2. 安装步骤3. 需要什么配置4. 有什么注意坑。这个 prompt 为什么有效因为它不是让 AI 逐字翻译而是让 AI 提取结构化的信息。插件说明本来就结构分明用这种方式拿到的结果比一整段中文译文好读得多。还有一个进阶技巧如果把插件界面截图发给 AI让它根据截图识别界面文字并说明每个按钮的作用效果也很好。这不是什么高深操作就是让 AI 帮你把英文界面变成“带注释的中文说明图”尤其适合配置界面复杂的插件。6. 常见问题与排查实录6.1 改了配置文件没反应这是问得最多的问题。按优先级排查确认你改的是不是正确的配置文件。可以用codex --version或者codex --help看有没有输出配置文件路径的命令。确认配置语法正确。TOML 格式要求缩进和键值写法严格多了个空格都可能解析失败。确认程序是否完全重启。CLI 程序一般启动时读取配置不重启不会重新加载。确认系统语言环境存在。执行locale -a看列表里有没有中文项。确认有没有其他配置覆盖了你的设置。环境变量的优先级通常高于配置文件检查 shell 配置里有没有导出过相关变量。我遇到过一次最诡异的排查配置写对了系统也支持中文但就是不生效。最后发现是 shell 启动脚本里有一个export LANGen_US.UTF-8把配置文件的设置覆盖了。环境变量优先级更高所以配置文件一直没机会生效。6.2 中文乱码怎么处理中文显示了但全是方块或者问号是终端编码问题不是 Codex 的问题。排查顺序确认系统 locale 是 UTF-8locale命令查看。Windows 终端里执行chcp 65001切到 UTF-8 代码页。确认终端字体支持中文。Windows 的默认终端字体换成“等线”或“微软雅黑”能解决大部分方块字问题。乱码问题比较隐蔽的地方在于你的系统可能默认是C.UTF-8或en_US.UTF-8这种情况下中文字符集没加载完全输出里偶尔会出现个别字符显示异常。直接在~/.bashrc或~/.zshrc里加上export LANGzh_CN.UTF-8是最彻底的解决办法。6.3 插件名、作者名还是英文属不属于没汉化成功不属于。插件名、作者名、插件 ID 这类信息来自插件本身的元数据不是界面语言的一部分。就像你给一个外国人起中文外号但身份证上的名字不可能跟着变。判断汉化是否成功看的是功能区文字、状态提示、说明文案不是看插件名。6.4 更新后配置被覆盖Codex 更新或安装新插件后配置文件偶尔会被重置或合并出问题。这就是我为什么在第 3 章强调备份。更稳的做法是把语言设置放在环境变量里而不是配置文件里。环境变量独立于配置文件更新程序时不会被触碰稳定性反而更高。如果你已经出现配置被覆盖的情况把备份文件恢复一下就行cp ~/.codex/config.toml.bak ~/.codex/config.toml恢复之后确认备份文件里的内容是不是你原来的完整配置别把一个旧版本直接覆盖到现在的新版本上。最后分享一个小技巧我个人在实际使用中最顺手的一套组合是在 shell 配置里固定导出LANGzh_CN.UTF-8这样所有跟 Codex 相关的命令行工具都自动中文显示不需要每个工具单独配置。IDE 那边只装一次语言包之后一劳永逸。网页版和描述阅读就看速查表。这套方案我用了很久没翻过车。你与其到处找汉化补丁不如花十分钟把这几件事配置好以后打开插件市场就再也不用对着英文页面发愣了。