???? 问题现象

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

很多人第一反应是：“是不是 VS Code 编码设置错了？”
但其实——问题不在编辑器，而在终端！

???? 真正的根源

Codex 并不直接在 VS Code 编辑器里写文件，而是通过终端（Terminal）执行命令（如 echo、sed、PowerShell 脚本等）来修改文件内容。

流程如下：

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

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

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

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

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

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

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

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

? 这一步确保 VS Code 读写一致。

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

1?? 确认你用的是哪个 PowerShell？

在终端运行：

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

2?? 找到你的 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，可能引发其他工具兼容问题。
我们需要的是 UTF-8 无 BOM。

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

4?? 验证是否生效

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

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

????? Windows CMD

临时切换：

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

???? Git Bash

编辑 ~/.bashrc，添加：

然后执行：

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

? 只要 终端写入 和 编辑器读取 都用 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 是最佳实践。

???? 小提示：如果你经常在多平台开发，建议将此脚本加入你的 Windows 初始化配置清单，一劳永逸解决编码问题！

作者：一位注重编码规范的 Windows 开发者
环境：Windows 10/11 + PowerShell 5.1/7 + VS Code
目标：让每一行中文都正确显示 ????

如需获取该脚本的 .ps1 文件或一键安装版，欢迎留言！