1. VSCode CodeX 写长代码中文为什么突然变乱码如果你在 Windows 下用 VSCode 配合 CodeX 这类 AI 编码助手生成含中文的长代码大概率遇到过这种场景生成的时候看着一切正常保存后重新打开中文注释变成了一堆问号或者方块再严重一点文件编码从UTF-8漂移成了UTF-8 with BOM甚至出现UTF-16 LEGit diff 里整片整片地飘红。这个问题不是 CodeX 本身写错了代码而是它把长代码交给终端去落盘时中间那层 shell 的编码行为不统一。Windows 上默认的终端往往是Windows PowerShell 5.1而 5.1 在文件输出编码这件事上历史包袱很重Out-File、、、Set-Content、Add-Content这几种写法在不同参数组合下可能产出UTF-16 LE也可能产出UTF-8 with BOM跟仓库里约定的UTF-8 无 BOM对不上。更麻烦的是长代码。一条命令塞不下整份文件时CodeX 会改成分批写入。每一批写入都可能用不同的编码和换行风格任何一步失败文件就停在半成品状态补写和修复又会制造额外 diff。于是任务从写代码演变成先修代码、再修编码、再修乱码、最后重新核对 diff。这篇面向需要在 VSCode 里稳定生成含中文长代码的开发者给出可跟做的排查路径装 PowerShell 7、把 VSCode 终端默认 shell 切到pwsh、用settings.json固化配置最后用一段含中文的长代码写入并校验文件编码。整套动作下来乱码问题基本能从根上消掉。2. 前置准备装 PowerShell 7 并确认 pwsh 可用核心思路一句话把执行写入的那层 shell 从Windows PowerShell 5.1换成PowerShell 7命令名pwsh。5.1 和 7 是两个独立产品装完会共存互不影响。先用 winget 看一下可安装的版本确认源里有货winget search --id Microsoft.PowerShell正常会列出稳定版和预览版类似名称 ID 版本 源 -------------------------------------------------------------------- PowerShell Microsoft.PowerShell 7.6.0.0 winget PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.101 winget选稳定版安装即可winget install --id Microsoft.PowerShell --source winget装完后不要急着关终端先开一个新的 PowerShell 窗口验证。这里有个高频坑装完不等于默认链路已经切过去。即使C:\Program Files\PowerShell\7已经进了PATH如果当前会话或工具默认调用的还是powershell.exe实际跑的仍然是 5.1。验证四连逐条敲Get-Command pwsh pwsh --version $PSVersionTable.PSVersion $PSHOME期望结果对照检查项期望输出Get-Command pwshC:\Program Files\PowerShell\7\pwsh.exepwsh --versionPowerShell 7.6.0$PSVersionTable.PSVersion主版本为7$PSHOMEC:\Program Files\PowerShell\7如果Get-Command pwsh报找不到说明安装目录没进PATH重开一个终端再试还不行就手动把C:\Program Files\PowerShell\7加到系统环境变量里。这一步过了才轮到 VSCode 那边配置。3. 可复制配置VSCode 终端 profile 与 settings.jsonVSCode 的集成终端默认走的是系统默认 shell得手动把它指到pwsh。有两种做法建议两个都做双保险。第一种改 VSCode 的settings.json。按CtrlShiftP输入Preferences: Open User Settings (JSON)在打开的 JSON 里加上终端 profile 配置{ terminal.integrated.profiles.windows: { PowerShell 7: { path: C:\\Program Files\\PowerShell\\7\\pwsh.exe, args: [-NoLogo] } }, terminal.integrated.defaultProfile.windows: PowerShell 7 }-NoLogo是去掉启动横幅让终端输出干净一点方便看写入日志。路径里的反斜杠要写成双反斜杠这是 JSON 转义要求写错了 VSCode 会直接报 profile 无效。第二种如果你用的是 CodeX 这类会自己拉起终端的工具还要确认它调用的 shell。有些工具会读环境变量SHELL或者自己维护一份 shell 路径配置把它显式指向pwsh.exe的完整路径别留成powershell。改完配置后重启 VSCode然后新建一个终端敲$PSVersionTable.PSVersion输出主版本是7说明 VSCode 集成终端已经切过去了。这一步没验证就往下走后面乱码照旧白折腾。注意terminal.integrated.defaultProfile.windows这个键在旧版 VSCode 里叫terminal.integrated.shell.windows已经废弃。如果你照着老教程改没生效先确认键名是不是新的。4. 验证请求写一段含中文长代码并校验编码配置对不对得用真实写入来验。下面这段脚本模拟 CodeX 分批写入含中文的长代码然后检查落盘文件的编码和内容完整性。先准备一段含中文的长代码内容用 here-string 写进变量避免引号转义把命令撑爆$content // 用户信息管理模块 // 负责用户资料的读取、更新与缓存同步 export interface UserProfile { id: number; name: string; // 昵称允许中文 nickname: string; // 备注信息可能包含多行中文 remark: string; } // 更新用户资料返回最新对象 export function updateProfile(profile: UserProfile): UserProfile { // 这里做一次浅拷贝避免污染原始引用 const next { ...profile }; // 中文备注做一次 trim去掉首尾空白 next.remark next.remark.trim(); return next; } $target Join-Path $PWD profile-demo.ts Set-Content -Path $target -Value $content -Encoding utf8NoBOM关键在-Encoding utf8NoBOM。PowerShell 7 支持这个值写出来就是UTF-8 无 BOM跟大多数仓库约定一致。5.1 没有这个选项这也是必须换 7 的原因之一。写完立刻校验编码和内容# 读前 3 个字节判断有没有 BOM $bytes [System.IO.File]::ReadAllBytes($target)[0..2] $bytes -join , # 用 UTF-8 读回内容确认中文没坏 Get-Content -Path $target -Encoding utf8 | Select-String 昵称期望结果前 3 个字节不是239,187,191那是 UTF-8 BOM 的标志Select-String能匹配到昵称这一行。如果字节里出现了255,254说明写成了UTF-16 LE编码还是没统一。再验一次分批写入的场景模拟长代码被拆成多段$part1 // 第一段中文注释n $part2 const msg 你好世界;n $part3 // 第三段结束n Set-Content -Path $target -Value $part1 -Encoding utf8NoBOM Add-Content -Path $target -Value $part2 -Encoding utf8NoBOM Add-Content -Path $target -Value $part3 -Encoding utf8NoBOM Get-Content -Path $target -Encoding utf8三段都指定utf8NoBOM读回来中文完整、换行正常就说明分批写入这条链路稳了。实测下来只要每一批都显式带编码参数BOM 漂移和乱码基本不会再出现。5. 本篇常见错排查报错一Set-Content : 找不到与参数名称Encoding匹配的参数说明当前跑的还是 5.1它不认识utf8NoBOM。回到第 2 节确认$PSVersionTable.PSVersion主版本是 7。如果 VSCode 终端里是 7、但 CodeX 调用的终端还是 5.1那就是工具侧的 shell 配置没改去它的配置里把 shell 路径指到pwsh.exe。报错二文件写出来带 BOMGit diff 整片飘红检查写入命令有没有漏掉-Encoding utf8NoBOM。和重定向在 7 里默认是utf8NoBOM但为了可读性和一致性建议统一用Set-Content/Add-Content显式带参数别依赖默认值。报错三中文变成问号或方块多半是写入时用了UTF-16 LE或者读取时编码没对上。用第 4 节的字节检查法确认落盘编码再用Get-Content -Encoding utf8读回。如果文件已经被写坏别在原文件上追加修复直接重新生成一份避免半成品状态叠加。报错四命令太长执行失败或者中间被截断这是长代码内联到单条命令的固有问题跟编码无关。解决办法就是分批写入每批都带-Encoding utf8NoBOM并且每批写完做一次内容校验。别指望一条命令塞下整份文件文件越大、中文越多、模板字符串越多越容易失败。报错五装了 PowerShell 7但pwsh命令找不到安装目录没进PATH。重开终端还不行就手动把C:\Program Files\PowerShell\7加到系统环境变量重启 VSCode 再试。提示排查顺序建议固定成先验版本、再验编码、最后验内容。版本不对后面全是白费编码不对内容校验也过不了。按这个顺序走能少绕很多弯。6. 把链路固化下来让 CodeX 稳定写中文整套动作的核心就三件事装 PowerShell 7、把 VSCode 终端和 CodeX 调用的 shell 都指到pwsh、所有写入命令显式带-Encoding utf8NoBOM。这三步做完长代码分批写入时的编码漂移和中文乱码基本能消掉。如果你还在用 CodeX 这类工具做长期编码和 Agent 任务建议把 shell 配置和编码参数写进项目级的配置里别每次靠记忆。需要长期跑编码任务的话可以看看 Coding Plan 的接入方式https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入前先去控制台把 API Key 建好https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite具体的接入参数和终端配置说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先验证模型对中文长代码的生成效果可以直接在模型对话里试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteAPI 入口统一走 https://taotoken.net/api配置时把 base URL 指过去就行。官网首页在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要看整体能力再点进去。最后留一个我踩过的坑改完settings.json一定要重启 VSCode光新建终端有时候不生效profile 是启动时加载的。重启后先敲$PSVersionTable.PSVersion确认版本再跑写入验证别跳过这步直接上长代码不然乱码了还得回头查是不是配置没生效。