Codex 中文乱码问题解决方案（Windows）

Codex 中文乱码问题解决方案Windows适用于 Codex / Copilot / AI 编码工具Java / TypeScript / Python 项目问题说明在 Windows 11 环境下使用 AI 编码工具时生成的代码中文经常变成乱码如æˆçˆ±ä¸­æ–‡、???导致编译失败。根本原因AI 工具输出 UTF-8但 Windows 终端默认使用 GBK 编码编码冲突导致乱码。CodexUTF-8→ Windows 终端GBK→ 文件写入错误编码→ IDE 读取UTF-8→ 乱码解决核心原则全链路统一为 UTF-8无 BOM步骤 1安装 Windows Terminal如果你用的是老式的命令提示符cmd黑窗口需要先装 Windows Terminal。打开 cmd运行wingetinstall--idMicrosoft.WindowsTerminal如果 winget 报错去Microsoft Store微软商店搜索 “Windows Terminal” 安装。装完后按Win键搜索“Terminal”打开。步骤 2安装 PowerShell 7在终端中运行wingetinstall--idMicrosoft.Powershell安装完成后输入pwsh启动验证版本pwsh$PSVersionTable确认PSEdition显示为Core即安装成功。步骤 3配置 PowerShell 7 的 Profile在 pwsh 中运行New-Item-Path$PROFILE-ItemTypeFile-Forcenotepad$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重新打开 pwsh输入以下命令验证[Console]::OutputEncoding显示UTF-8即配置成功。步骤 4将 Windows Terminal 默认终端改为 pwsh打开 Windows Terminal点击标签页旁边的下拉箭头∨或按Ctrl ,左侧选择“启动”“默认配置文件”改为PowerShell 7pwsh点“保存”⚠️ 不要使用powershell.exe旧版或cmd.exe步骤 5配置 IDE 编码VSCode按Ctrl ,打开设置Files: Encoding→ 设为utf8Files: Auto Guess Encoding→关闭或直接在settings.json中添加{files.encoding:utf8,files.autoGuessEncoding:false}IntelliJ IDEA进入Settings → Editor → File EncodingsGlobal Encoding →UTF-8Project Encoding →UTF-8步骤 6项目级编码配置在项目根目录创建两个文件.editorconfigroottrue[*]charsetutf-8 end_of_linelf.gitattributes*textautoeollf *.java text working-tree-encodingUTF-8 *.ts text working-tree-encodingUTF-8 *.js text working-tree-encodingUTF-8步骤 7给 Codex 添加 Prompt 约束在与 Codex 对话时提前加上以下约束生成代码必须遵守1. 所有文件编码 UTF-8无 BOM2. 禁止 UTF-16 / GBK3. 中文直接输出不允许\uXXXX4. 文件写入必须使用 UTF-8步骤 8注意写文件的方式❌不要用这些方式写文件会产生 UTF-16echo中文file.txt Out-File file.txt✅使用这种方式Set-Content file.txt-Encodingutf8步骤 9进阶WSL / Bash 环境如果 Codex 调用 bash 时出现乱码设置环境变量$env:WSL_UTF81验证是否配置成功运行以下命令测试Set-Content test.txt你好世界-Encodingutf8用记事本或 VSCode 打开test.txt中文正常显示即配置成功。优先级总结优先级操作重要程度1安装 Windows Terminal⭐⭐⭐ 必须2安装 PowerShell 7⭐⭐⭐ 必须3配置 UTF-8 Profile⭐⭐⭐ 必须4改默认终端为 pwsh⭐⭐⭐ 必须5IDE 设置 UTF-8⭐⭐⭐ 必须6添加 .editorconfig⭐⭐ 推荐7Codex Prompt 约束⭐⭐ 推荐8WSL_UTF8 配置⭐ 进阶完成以上配置后可以解决90% 以上的 Codex 中文乱码问题。