彻底解决 Copilot 与 Codex 中文乱码问题（附自动化脚本）

引言

在使用 GitHub Copilot 或 OpenAI Codex 自动重构代码时，你是否遇到过这样的尴尬：AI 生成的代码逻辑完美，但原本注释里的中文却变成了 æˆ'爱中文 这样的乱码？有时候这种字符甚至会污染正确的代码，带来巨大的稳定性隐患。

一、问题核心：被忽视的'终端中转'

乱码的根源不在于 AI 的大脑，也不在于编辑器的显示，而在于执行链路的编码不一致。

Copilot/Codex 在执行某些修改任务（如：重构整个文件或批量替换）时，往往会通过终端调用系统指令。由于 Windows 终端（PowerShell/CMD）默认使用 GBK 编码，它在处理 AI 传来的 UTF-8 字节时会发生'误读'，导致写入文件的内容从源头上就损坏了。

二、解决方案：构建全链路 UTF-8 环境

与其手动改配置，不如直接跑一套自动化脚本。这能确保系统环境变量、PowerShell 启动策略以及 VS Code 的全局设置都同步为 UTF-8。

操作步骤

1. 新建一个 .txt 文件，将下方代码完整复制进去。
2. 保存并更名为 fix_all_encoding.bat。
3. 右键点击，选择'以管理员身份运行'。

@echo off
setlocal enabledelayedexpansion
title AI 编程环境编码一键优化工具
:: 1. 权限验证
net session >nul 2>&1
if %errorLevel% neq 0 (
    echo [错误] 请右键点击此文件，选择'以管理员身份运行'！
    pause
    exit /b
)
echo [*] 正在初始化环境...
:: 2. 设置系统级环境变量
echo [*] 配置系统环境变量 (UTF-8)...
setx /m PYTHONUTF8 "1" >nul
setx /m LESSCHARSET "utf-8" >nul
:: 3. 配置 PowerShell Profile
echo [*] 配置 PowerShell 启动策略...
powershell -NoProfile -ExecutionPolicy Bypass -Command ^
 "$p = Split-Path $PROFILE; if (!(Test-Path $p)) { New-Item -ItemType Directory -Path $p -Force }; ^
 $content = '$OutputEncoding = [Console]::InputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8; [System.Console]::InputEncoding = [System.Text.Encoding]::UTF8; [System.Console]::OutputEncoding = [System.Text.Encoding]::UTF8'; ^
 if (Test-Path $PROFILE) { $old = Get-Content $PROFILE; if ($old -notcontains '$OutputEncoding = [Console]::InputEncoding') { Add-Content -Path $PROFILE -Value $content } } else { Set-Content -Path $PROFILE -Value $content -Encoding UTF8 }"
:: 4. 智能合并 VS Code 设置
echo [*] 同步 VS Code 全局设置...
set "VSC_SETTINGS=%APPDATA%\Code\User\settings.json"
if exist "%VSC_SETTINGS%" (
    powershell -NoProfile -ExecutionPolicy Bypass -Command ^
     "$path = '%VSC_SETTINGS%'; ^
     $json = Get-Content $path -Raw | ConvertFrom-Json; ^
     $json | Add-Member -NotePropertyName 'files.encoding' -NotePropertyValue 'utf8' -Force; ^
     $json | Add-Member -NotePropertyName 'files.autoGuessEncoding' -NotePropertyValue $true -Force; ^
     $json | ConvertTo-Json -Depth 100 | Set-Content $path -Encoding UTF8"
    echo [+] VS Code 设置已同步。
)
echo.
echo ---------------------------------------------------
echo [+] 配置成功！
echo [提示] 请重启 VS Code 终端或重启编辑器以使配置生效。
echo ---------------------------------------------------
pause

脚本主要做了四件事：