??? 解決 Codex 修改文件后中文亂碼問題：根源在終端編碼，不在 VS Code！

關(guān)鍵詞：Codex、中文亂碼、VS Code、PowerShell、UTF-8、終端編碼、無 BOM

?? 問題現(xiàn)象

使用 GitHub Copilot（或 Codex）修改包含中文的文件時，保存后打開發(fā)現(xiàn)中文變成亂碼，比如：

??‘??±??-?–? → 實際應為 “我愛中文”

很多人第一反應是：“是不是 VS Code 編碼設置錯了？”
但其實——問題不在編輯器，而在終端！

?? 真正的根源

Codex 并不直接在 VS Code 編輯器里寫文件，而是通過終端（Terminal）執(zhí)行命令（如 echo、sed、PowerShell 腳本等）來修改文件內(nèi)容。

流程如下：

1. Codex 生成修改命令（例如 Set-Content file.txt "你好"）
2. 命令在 終端中執(zhí)行
3. 終端以當前編碼將字節(jié)寫入文件
4. VS Code 讀取文件 → 如果編碼不匹配 → 亂碼

?? 所以，亂碼的根本原因是：終端編碼 ≠ 編輯器編碼。

? 解決方案：雙端統(tǒng)一為 UTF-8

要徹底解決，必須同時配置：

1. VS Code 使用 UTF-8
2. 終端（PowerShell/CMD）默認使用 UTF-8

第一步：配置 VS Code 為 UTF-8

打開 VS Code 設置（Ctrl + ,），切換到 settings.json，添加：

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

• "files.encoding": "utf8"：默認以 UTF-8 保存文件
• "files.autoGuessEncoding": true：打開文件時自動檢測編碼（尤其對帶 BOM 的文件友好）

? 這一步確保 VS Code 讀寫一致。

第二步：配置 PowerShell 終端為 UTF-8（重點！）

1?? 確認你用的是哪個 PowerShell？

在終端運行：

$PSVersionTable.PSVersion

• 5.x → Windows 自帶的 Windows PowerShell（舊版）
• 7.x → PowerShell 7+（推薦升級）

?? 強烈建議升級到 PowerShell 7，對 UTF-8 支持更好。

2?? 找到你的 Profile 文件路徑

$PROFILE

常見路徑：

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

3?? 使用安全腳本配置 UTF-8（無 BOM）

?? 注意：不要用 Add-Content -Encoding UTF8，它會寫入 帶 BOM 的 UTF-8，可能引發(fā)其他工具兼容問題。
我們需要的是 UTF-8 無 BOM。

運行以下完整腳本（支持冪等、避免重復、兼容 Win7/10/11）：

# Setup-UTF8PowerShellProfile.ps1
$utf8Config = @'
# 設置控制臺使用 UTF-8 編碼（無 BOM）
chcp 65001 | Out-Null
[Console]::InputEncoding  = [System.Text.UTF8Encoding]::new()
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
$OutputEncoding = [System.Text.UTF8Encoding]::new()
# 設置默認文件操作編碼為 UTF-8（無 BOM）
$PSDefaultParameterValues['Out-File:Encoding']    = 'utf8'
$PSDefaultParameterValues['Set-Content:Encoding'] = 'utf8'
$PSDefaultParameterValues['Add-Content:Encoding'] = 'utf8'
'@
# 創(chuàng)建目錄（如果不存在）
$profileDir = Split-Path -Parent $PROFILE
if (-not (Test-Path $profileDir)) {
    New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
}
# 讀取現(xiàn)有內(nèi)容
$existing = if (Test-Path $PROFILE) { Get-Content $PROFILE -Raw } else { "" }
# 檢查是否已配置（避免重復）
$hasConfig = $existing -match 'Console::OutputEncoding' -and
             $existing -match '\$OutputEncoding' -and
             $existing -match "PSDefaultParameterValues.*Out-File:Encoding"
if (-not $hasConfig) {
    $newContent = if ($existing) { "$existing`r`n$utf8Config" } else { $utf8Config }
    $utf8NoBom = New-Object System.Text.UTF8Encoding($false)  # $false = 無 BOM
    [System.IO.File]::WriteAllText($PROFILE, $newContent, $utf8NoBom)
    Write-Host "? UTF-8 配置已寫入 Profile！路徑: $PROFILE" -ForegroundColor Green
} else {
    Write-Host "?? UTF-8 已配置，跳過。" -ForegroundColor Cyan
}
# 立即生效
. $PROFILE

4?? 驗證是否生效

'中文測試' | Set-Content .\test.txt
Get-Content .\test.txt

如果輸出 “中文測試” 而非亂碼，說明配置成功！

第三步：其他終端的 UTF-8 配置（可選）

??? Windows CMD

臨時切換：

chcp 65001

?? 僅對當前窗口有效。不建議長期使用 CMD 處理中文，推薦改用 PowerShell。

?? Git Bash

編輯 ~/.bashrc，添加：

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

然后執(zhí)行：

source ~/.bashrc

?? 總結(jié)：亂碼問題的終極解法

? 只要 終端寫入 和 編輯器讀取 都用 UTF-8（無 BOM），Codex 修改中文文件就再也不會亂碼！

?? 附：為什么推薦 UTF-8 無 BOM？

• BOM（Byte Order Mark）在 Windows 記事本中常見，但 Linux/macOS 工具（如 cat、grep、Python）可能將其視為普通字符，導致解析錯誤。
• VS Code、Git、Node.js、Python 等現(xiàn)代工具默認期望無 BOM 的 UTF-8。
• 作為開發(fā)者，統(tǒng)一使用 UTF-8 無 BOM 是最佳實踐。

?? 小提示：如果你經(jīng)常在多平臺開發(fā)，建議將此腳本加入你的 Windows 初始化配置清單，一勞永逸解決編碼問題！

作者：一位注重編碼規(guī)范的 Windows 開發(fā)者
環(huán)境：Windows 10/11 + PowerShell 5.1/7 + VS Code
目標：讓每一行中文都正確顯示 ??

如需獲取該腳本的 .ps1 文件或一鍵安裝版，歡迎留言！

到此這篇關(guān)于解決 Codex 修改文件后中文亂碼問題:根源在終端編碼,不在 VS Code的文章就介紹到這了,更多相關(guān)Codex修改文件中文亂碼內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論