Windows11下Codex中文乱码问题全链路解决方案

一、问题背景

最近在Windows 11上用Codex桌面端写代码，频繁遇到中文乱码导致项目编译失败。试着让Codex自己修复，结果不仅耗时，还疯狂消耗额度。网上的资料东一块西一块，干脆自己整理一份全链路方案，帮大家一次性解决这个烦人的问题。

用Codex（或Copilot这类AI编码工具）在Windows 11上生成代码时，常见的问题就两个：

中文乱码（我爱中文 / ??? / u4e2du6587）
编译失败 / 文件损坏 / 频繁手动修复

二、核心结论（必须理解）

先给个定论：Codex中文乱码

。

本质是什么？

。

Codex（UTF-8）
↓
Windows 终端（GBK / UTF-16）
↓
文件写入（错误编码）
↓
IDE 按 UTF-8 读取
↓
乱码

Windows默认终端到现在还在用历史代码页（GBK/936），而现代工具清一色UTF-8——这俩根本不在一个频道上。

三、问题根因拆解

终端编码不一致（最核心）

• Codex / Node / CLI → UTF-8
• Windows PowerShell 5 → GBK / UTF-16

编码“误读”就这么发生了。

Codex 实际通过终端写文件

Codex并不是直接修改文件，而是：

生成命令 → 终端执行 → 写入文件

如果终端编码是错的，文件写入的一瞬间就坏了。

编辑器编码 ≠ 终端编码

哪怕VSCode或IDEA设成了UTF-8，只要终端写入时用的是GBK，照样乱码。终端才是真正的“守门员”。

PowerShell 写文件默认坑

写法	实际编码
>	UTF-16
Out-File	UTF-16
Set-Content	不稳定

多链路问题（进阶）

• WSL / bash 走不同编码链路
• Codex 可能调用 PS5 而不是 PS7
• Git / IDE / Shell 编码不统一

四、最终解决思路（核心原则）

别想着局部修补，直接让整个链条从生成到写入到读取都走UTF-8，一劳永逸。

五、一步到位解决方案（推荐执行）

使用 PowerShell 7（必须）

winget install --id Microsoft.Powershell

启动：

pwsh

验证：

$PSVersionTable

输出：

PSEdition : Core

PowerShell 7 默认就是UTF-8，省心。

强制 PowerShell UTF-8（关键）

notepad $PROFILE

写入：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

$PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'
$PSDefaultParameterValues['Set-Content:Encoding'] = 'utf8'
$PSDefaultParameterValues['Add-Content:Encoding'] = 'utf8'

Windows Terminal 使用 pwsh

确保默认终端是PowerShell 7（pwsh），而不是：

powershell.exe（旧版）
cmd.exe

IDE 统一 UTF-8

{
  "files.encoding": "utf8",
  "files.autoGuessEncoding": false
}

Global Encoding → UTF-8
Project Encoding → UTF-8

项目级强制编码

.editorconfig

root = true

[*]
charset = utf-8
end_of_line = lf

.gitattributes

* text=auto eol=lf

*.ja va text working-tree-encoding=UTF-8
*.ts text working-tree-encoding=UTF-8
*.js text working-tree-encoding=UTF-8

Codex Prompt 约束（非常重要）

在给Codex的提示词里明确要求：

• 所有文件编码 UTF-8（无 BOM）
• 禁止 UTF-16 / GBK
• 中文直接输出，不允许 uXXXX
• 文件写入必须使用 UTF-8

这能显著降低乱码概率，算是从源头掐断问题。

避免错误写法

别再用这些：

echo "中文" > file.txt
Out-File file.txt

换成：

Set-Content file.txt -Encoding utf8

WSL / Bash 特殊情况（进阶）

如果Codex调用bash出现乱码：

$env:WSL_UTF8="1"

或者配置：

[shell_environment_policy.set]
WSL_UTF8 = "1"

六、验证是否修复成功

方法1

[Console]::OutputEncoding

应该返回：

UTF-8

方法2

生成中文文件测试：

Set-Content test.txt "你好" -Encoding utf8

打开文件，正常显示“你好”就对了。

方法3

查看PowerShell类型：

$PSVersionTable

七、最终标准（企业推荐）

Windows Terminal + PowerShell 7
+ UTF-8（无 BOM）
+ .editorconfig
+ .gitattributes
+ Codex Prompt 约束

八、一句话总结

Codex乱码本质上不是AI的问题，而是：

解决方案：统一为UTF-8（无BOM），让整个链路说同一种语言。

九、效果

完成以上配置后：

• 中文不再乱码
• 编译稳定
• 无需手动修复文件
• Codex 可以稳定用了

必须做：

• PowerShell 7
• UTF-8 Profile
• IDE UTF-8

推荐做：

• editorconfig
• Codex Prompt

进阶：

• WSL_UTF8
• Git Hook

这套方案能解决

，适用于：

• Windows 11
• Ja va / TS / Python 项目
• Codex / Copilot / AI 编码工具