Codex中文乱码如何处理?Windows下Codex乱码成因排查与解决方案详解

Codex 客户端在写代码过程中出现中文乱码，根本原因并非 Codex 本身，而是 Windows 系统终端（尤其是 PowerShell 5）默认使用 GBK 编码，而 Codex 生成的内容基于 UTF-8，导致编码不匹配。以下是系统性解决方案

核心处理思路

终端、编辑器与文件操作应统一采用 UTF-8（无 BOM），确保全链路编码一致。

详细操作步骤

将版本升级到 PowerShell 7

编码支持方面，UTF-8 是 PowerShell 7 的默认选项，PowerShell 5 默认的则是 GBK。

运行操作请在 Windows Terminal 或命令提示符中完成：

winget install --id Microsoft.Powershell

完成安装以后，输入 pwsh 版本验证需在 PowerShell 7 启动后进行：

$PSVersionTable.PSVersion

应当输出 7.x，同时 PSEdition 应显示为 Core。

配置 PowerShell 7 强制使用 UTF-8（无 BOM）

编辑 PowerShell 配置文件（Profile）：

通过 PowerShell 7 运行：

New-Item -Path $PROFILE -ItemType File -Force
notepad $PROFILE

保存前粘贴以下内容：

chcp 65001 | Out-Null
[Console]::InputEncoding = [System.Text.UTF8Encoding]::new()
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
$OutputEncoding = [System.Text.UTF8Encoding]::new()
$PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'
$PSDefaultParameterValues['Set-Content:Encoding'] = 'utf8'
$PSDefaultParameterValues['Add-Content:Encoding'] = 'utf8'

完成 PowerShell 7 重启后检查编码：

[Console]::OutputEncoding

应当显示为 UTF-8。

配置 VS Code 使用 UTF-8 和 PowerShell 7

打开 VS Code 设置（Ctrl + ,），再切换至 settings.json，随后添加：

{
"files.encoding": "utf8",
"files.autoGuessEncoding": true,
"terminal.integrated.defaultProfile.windows": "PowerShell",
"terminal.integrated.profiles.windows": {
"PowerShell": {
"path": "C:\Program Files\PowerShell\7\pwsh.exe"
}
}
}

按 Ctrl + Shift + P，输入 Terminal: Select Default Profile，选择 PowerShell。

在 Codex 指令内明确要求编码

UTF-8 必须在发送给 Codex 的指令中被明确指定，例如：

“请编辑此文件，要求：文件编码为 UTF-8（无 BOM），中文注释直接输出，禁止 uXXXX 转义，写入时使用 UTF-8 编码。”

（可选）制定项目级编码规范

在项目根目录中创建 .editorconfig 文件：

root = true
[*]
charset = utf-8
end_of_line = lf

常见误区说明

不要依赖 chcp 65001 进行临时切换（只对当前会话生效）。

不要使用 > 或者 Out-File 写入文件（默认会生成 UTF-16）。

建议使用 Set-Content -Encoding utf8 或者 Add-Content -Encoding utf8。

检查问题是否解决

在 VS Code 终端中运行：

[Console]::OutputEncoding

显示 UTF-8 便说明终端编码设置正确。

让 Codex 生成包含中文内容的代码，例如中文注释；保存文件后，中文应能正常显示。

以上配置完成后，超过 90% 的 Codex 中文乱码问题都能得到彻底解决。