Codex 中文乱码问题

Rinhon

在干嘛？

偷偷学习中...

标签

站点统计

文章

14

分类

10

标签

24

总字数

14,875

运行时长

0 天

最后活动

0 天前

901 字

5 分钟

Codex 中文乱码问题

2025-12-29

Uncategorized

无标签

解决 Codex 修改文件后中文乱码问题：根源在终端编码！#

关键词：Codex、中文乱码、VS Code、PowerShell、UTF-8、终端编码、无 BOM

问题现象#

使用 GitHub Copilot（或 Codex）修改包含中文的文件时，保存后打开发现中文变成乱码，比如：

1
æˆ‘çˆ±ä¸æ–‡ → 实际应为 “我爱中文”

傻杯codex!!

真正的根源#

Codex 是通过终端（Terminal）执行命令（如 echo、sed、PowerShell 脚本等）来修改文件内容。

流程如下：

Codex 生成修改命令（例如 Set-Content file.txt "你好"）
命令在 终端中执行
终端以当前编码将字节写入文件
VS Code 读取文件 → 如果编码不匹配 → 乱码

所以，乱码的根本原因是：终端编码 ≠ 编辑器编码。

解决方案：双端统一为 UTF-8#

要彻底解决，必须同时配置：

VS Code 使用 UTF-8
终端（PowerShell/CMD）默认使用 UTF-8

第一步：配置 VS Code 为 UTF-8#

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

1
{
2
"files.encoding": "utf8",
3
"files.autoGuessEncoding": true
4
}

"files.encoding": "utf8"：默认以 UTF-8 保存文件
"files.autoGuessEncoding": true：打开文件时自动检测编码（尤其对带 BOM 的文件友好）

确保 VS Code 读写一致。

第二步：配置 PowerShell 终端为 UTF-8（重点！）#

PowerShell升级最新版本#

在终端运行：

1
$PSVersionTable.PSVersion

5.x → Windows 自带的 Windows PowerShell（旧版）
7.x → PowerShell 7+（推荐升级）

强烈建议升级到 PowerShell 7，对 UTF-8 支持更好。

找到 Profile 文件路径#

1
$PROFILE

常见路径：

Windows PowerShell 5.1：
C:\Users\<用户名>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
PowerShell 7+：
C:\Users\<用户名>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

使用安全脚本配置 UTF-8（无 BOM）#

注意：不要用 Add-Content -Encoding UTF8，它会写入 带 BOM 的 UTF-8，可能引发其他工具兼容问题。
我们需要的是 UTF-8 无 BOM。

运行以下完整脚本（支持幂等、避免重复、兼容 Win7/10/11）：

1
$utf8Config = @'
2
# 设置控制台使用 UTF-8 编码（无 BOM）
3
chcp 65001 | Out-Null
4
[Console]::InputEncoding  = [System.Text.UTF8Encoding]::new()
5
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
6
$OutputEncoding = [System.Text.UTF8Encoding]::new()
7
# 设置默认文件操作编码为 UTF-8（无 BOM）
8
$PSDefaultParameterValues['Out-File:Encoding']    = 'utf8'
9
$PSDefaultParameterValues['Set-Content:Encoding'] = 'utf8'
10
$PSDefaultParameterValues['Add-Content:Encoding'] = 'utf8'
11
'@
12
# 创建目录（如果不存在）
13
$profileDir = Split-Path -Parent $PROFILE
14
if (-not (Test-Path $profileDir)) {
15
New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
16
}
17
# 读取现有内容
18
$existing = if (Test-Path $PROFILE) { Get-Content $PROFILE -Raw } else { "" }
19
# 检查是否已配置（避免重复）
20
$hasConfig = $existing -match 'Console::OutputEncoding' -and
21
$existing -match '\$OutputEncoding' -and
22
$existing -match "PSDefaultParameterValues.*Out-File:Encoding"
23
if (-not $hasConfig) {
24
$newContent = if ($existing) { "$existing`r`n$utf8Config" } else { $utf8Config }
25
$utf8NoBom = New-Object System.Text.UTF8Encoding($false)  # $false = 无 BOM
26
[System.IO.File]::WriteAllText($PROFILE, $newContent, $utf8NoBom)
27
Write-Host "✅ UTF-8 配置已写入 Profile！路径: $PROFILE" -ForegroundColor Green
28
} else {
29
Write-Host "ℹ️ UTF-8 已配置，跳过。" -ForegroundColor Cyan
30
}
31
# 立即生效
32
. $PROFILE

4️⃣ 验证是否生效#

1
'中文测试' | Set-Content .\test.txt
2
Get-Content .\test.txt

如果输出 “中文测试” 而非乱码，说明配置成功！

第三步：其他终端的 UTF-8 配置（可选）#

️ Windows CMD#

临时切换：

1
chcp 65001

⚠️ 仅对当前窗口有效。不建议长期使用 CMD 处理中文，推荐改用 PowerShell。

Git Bash#

编辑 ~/.bashrc，添加：

1
export LANG="zh_CN.UTF-8"
2
export LC_ALL="zh_CN.UTF-8"

然后执行：

1
source ~/.bashrc

总结：乱码问题的终极解法#

组件	配置项	目的
VS Code	`"files.encoding": "utf8"`	编辑器读写统一为 UTF-8
PowerShell	Profile 中设置 Console + `$OutputEncoding` + `$PSDefaultParameterValues`	终端命令输出 UTF-8 无 BOM
CMD	`chcp 65001`（临时）	切换代码页为 UTF-8
Git Bash	`export LANG=zh_CN.UTF-8`	环境变量强制 UTF-8

✅ 只要 终端写入 和 编辑器读取 都用 UTF-8（无 BOM），Codex 修改中文文件就再也不会乱码！

附：为什么推荐 UTF-8 无 BOM？#

BOM（Byte Order Mark）在 Windows 记事本中常见，但 Linux/macOS 工具（如 cat、grep、Python）可能将其视为普通字符，导致解析错误。
VS Code、Git、Node.js、Python 等现代工具默认期望无 BOM 的 UTF-8。
作为开发者，统一使用 UTF-8 无 BOM 是最佳实践。

https://www.cnblogs.com/gccbuaa/p/19227315

如果这篇文章对你有帮助，欢迎分享给更多人！