结论先说
- 中文乱码的根因几乎都是代码页不一致(GBK 936 对撞 UTF-8 65001)。简体中文 Windows 的旧版 CMD 和 PowerShell 5.1 默认采用 GBK 编码,而 Codex CLI 及其调用的 Node、Python、Git 子进程普遍输出 UTF-8;两边编码未对齐,汉字和终端 TUI 边框就会乱码。
- 最省心的升级组合是「Windows Terminal + PowerShell 7(
pwsh)」。弃用老旧的蓝色 PowerShell 5.1 和传统控制台宿主(conhost),并在$PROFILE中统一将输入输出编码固定为 UTF-8,可一次性消除大部分乱码与滚动错位。 - 路径反斜杠报错高发在两个地方:一是
config.toml/ JSON 配置里在双引号中写了单个反斜杠(例如"C:\Users\name"里的\U或\n会被当成非法转义符);二是模型按 Linux 习惯生成了 Bash 语法或混用引号,在 PowerShell 5.1 里直接报语法错。 - 如果项目脚本大量依赖 Linux Bash 命令,官方也建议直接切到 WSL2。在纯 Linux 工具链环境下跑 Codex CLI,编码和路径分隔符问题都会自然消失。
- 把 Windows 本地终端环境调顺后,可搭配高稳定度会员持续开发。国内无外币卡的用户可在本站开通 ChatGPT Plus 或高配额 ChatGPT Pro,团队集中采购可看 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Codex CLI 与 Windows 终端编码机制整理的示意图
本文根据 OpenAI Codex 官方文档《Codex CLI》《Configuration Reference》《Windows app》《WSL》及官方仓库 Windows 终端使用说明整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 在简体中文版 Windows 的 PowerShell 5.1 或传统 CMD 窗口运行 Codex CLI,遇到中文输出显示成乱码、方框或问号的开发者;
- 让 Codex 修改文件、配置
config.toml或运行脚本时,频繁遇到路径反斜杠\引发转义报错、invalid escape sequence或命令语法不兼容的用户; - 想知道怎么一步配好 Windows Terminal、PowerShell 7 与 UTF-8 环境变量,以及何时该直接切换 WSL2 的人。
一、四步彻底修好 Windows PowerShell / CMD 中文乱码
以下为本站建议的 Windows 本地终端 UTF-8 标准化配置流程,配完一次即可长期生效:

图:本站根据 OpenAI Codex 官方文档:Windows 与 PowerShell 编码规范整理的示意图
第 1 步:改用 Windows Terminal 与 PowerShell 7(pwsh)
传统 cmd.exe 和系统内置的 PowerShell 5.1 对现代 TUI 界面、ANSI 颜色及宽字符渲染支持较弱(遇到终端滚动异常也可联动看 /guides/codex-cli-cannot-scroll-terminal-display)。建议通过 Microsoft Store 或 winget 安装 Windows Terminal 与 PowerShell 7:
powershell
winget install Microsoft.WindowsTerminal
winget install Microsoft.PowerShell
安装完成后,打开 Windows Terminal 设置,将默认配置文件切为 PowerShell 7(pwsh.exe),字体选用支持中文与等宽符号的字体(如 Cascadia Mono 或 Sarasa Term SC)。
第 2 步:在 PowerShell $PROFILE 中固化 UTF-8 编码(本站建议)
在 PowerShell 7 中运行 notepad $PROFILE(若提示文件不存在则新建),写入以下配置并保存,重启终端后生效:
powershell
# 统一控制台输入输出与管道编码为无 BOM UTF-8
$utf8NoBom = [System.Text.UTF8Encoding]::new($false)
[Console]::InputEncoding = $utf8NoBom
[Console]::OutputEncoding = $utf8NoBom
$OutputEncoding = $utf8NoBom
# 让 Python 与部分 CLI 工具默认使用 UTF-8
$env:PYTHONUTF8 = "1"
$env:PYTHONIOENCODING = "utf-8"
# 如仍需兼容旧控制台子进程,可顺手切代码页到 65001
chcp 65001 > $null
如果你偶尔必须在传统 CMD 里临时启动 Codex,在运行 codex 前先手动执行 chcp 65001 切换当前窗口代码页。
第 3 步:修正 Git 中文文件名八进制转义乱码
很多人看到 git status 或 Codex Diff 里中文路径变成 \346\226\207\344\273\266,这其实是 Git 默认把非 ASCII 路径做了八进制转义。运行下面三条全局配置即可正常显示中文:
powershell
git config --global core.quotepath false
git config --global i18n.commitEncoding utf-8
git config --global i18n.logOutputEncoding utf-8
第 4 步:按需开启系统级 Beta UTF-8 开关(注意兼容边界)
如果某些旧版 Windows 工具仍顽固输出 GBK,可在「控制面板 → 时钟和区域 → 区域 → 管理 → 更改系统区域设置」中勾选「Beta 版:使用 Unicode UTF-8 提供全球语言支持」并重启。但本站提醒:该系统全局开关可能让极少数老旧国产财务软件或仅支持 GBK 的传统客户端出现界面乱码,有此类依赖的电脑优先采用前 3 步的终端级方案即可。
排障与订阅提示:在 Windows 下顺畅跑通 CLI 后,连续重构代码和跑本地测试很容易触及普通套餐的调用上限。若需要更高额度保障,可按需升级 ChatGPT Pro 充值 或选择 ChatGPT Pro 20x iOS 可覆盖档;新号注册登录如遇手机号验证受阻,也可了解 Codex 注册手机验证服务。
二、彻底避开路径反斜杠报错与 Shell 语法冲突
中文显示正常后,Windows 开发者遇到的第二大高频问题就是路径里的反斜杠 \ 导致报错。常见有以下三处:
config.toml里路径写错导致 TOML 解析失败:在 TOML 规范里,双引号字符串会把\U、\t、\n当作转义字符。例如写"C:\Users\tom\new-app"时,\U和\t、\n都会触发解析错误。正确写法有三种,推荐前两种:
toml
# 推荐 1:使用单引号字面量字符串(不解析反斜杠)
# 推荐 2:在支持正斜杠的字段直接使用正斜杠 C:/Users/tom/new-app
# 示例:
[projects.'C:\Users\tom\new-app']
trust_level = "trusted"
完整配置语法可参考 /guides/codex-config-toml-complete-guide。
- 模型默认生成 Bash 语法(
&&、export、rm -rf)在 PowerShell 5.1 报错:PowerShell 5.1 不支持&&链式连接符,也不识别export KEY=value;升级到 PowerShell 7 后可支持&&,同时建议在项目根目录AGENTS.md中写明一句:开发环境为 Windows PowerShell 7,禁止使用 export / rm -rf 等 Bash 独占语法,路径统一使用正斜杠或 PowerShell 原生命令。 - 跨环境仓库优先切 WSL2:如果团队仓库的
Makefile、构建脚本和路径拼接深度绑定 Linux Shell,在 Windows 原生 PowerShell 里反复兜底成本很高。按官方 WSL 文档将代码放进 WSL2 内部 Linux 文件系统(如~/code/,注意不要放在/mnt/c下跨盘读写),体验与原生 Linux 基本一致。如需排查 Windows 桌面端与原生沙箱的其他问题,可对照 /guides/codex-windows-sandbox-setup-failed 与 /guides/codex-set-chinese-language。
常见问题
问:我已经执行了 chcp 65001,为什么某些工具的中文输出还是乱码?
答:仅改控制台代码页不会改变 PowerShell 自身管道编码($OutputEncoding)和 Python 默认编码。必须同时在 $PROFILE 中设置 [Console]::OutputEncoding、$OutputEncoding 与 $env:PYTHONUTF8 = "1",并确保使用支持中文字符集的等宽字体。
问:在 VS Code 内置终端跑 Codex CLI 同样中文乱码怎么处理?
答:检查 VS Code 设置中的 terminal.integrated.defaultProfile.windows 是否指向了旧版 PowerShell 5.1 或 CMD;将其改为 PowerShell 7(pwsh),重启终端即可继承你写好的 $PROFILE UTF-8 配置。
问:国内没有外币卡,或者 Plus 额度不够想升级 Pro / 团队版怎么开通?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Plus(含 Plus iOS 可覆盖版)或高配额 ChatGPT Pro,团队多人研发亦可选择企业定制方案。支持支付宝、微信支付与 AlipayHK,提供免交密码自助卡密兑换并支持开具增值税发票,价格以商品页实时展示为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围的说明。
相关教程
- Codex CLI 终端无法滚动或显示错位怎么办
- Codex 怎么设置中文界面与中文回复
- Codex config.toml 完整配置指南
- Codex 沙箱初始化失败怎么办(Windows)
- Codex 常见报错总表
参考资料
- OpenAI Codex 官方文档:Codex CLI — https://developers.openai.com/codex/cli
- OpenAI Codex 官方文档:Configuration Reference — https://developers.openai.com/codex/config-reference
- OpenAI ChatGPT Learn:ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
- OpenAI ChatGPT Learn:WSL — https://learn.chatgpt.com/docs/windows/wsl
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~