Codex 修改文件导致中文乱码的解决办法：把 VS Code 与 PowerShell 编码改到 TaoToken 工作流

1. Codex 改完文件中文变问号问题到底出在哪先说结论Codex 修改文件后中文乱码绝大多数情况不是 VS Code 的锅也不是 Codex 模型本身把字写错了而是写入链路和读取链路的编码不一致。Codex 在终端里执行命令改文件终端用什么编码写文件就是什么字节VS Code 用什么编码读就决定你看到的是正常中文还是一串问号方块。我先把这条链路拆开。你在 VS Code 里唤起 Codex让它改一个含中文的.md或.py文件它实际做的事情大致是在集成终端里跑Set-Content、Out-File、sed、echo这类命令把新内容写回磁盘。注意这一步不经过 VS Code 的编辑器缓冲区所以你在settings.json里设的files.encoding管不到它。终端进程有自己的输入输出编码Windows 上默认往往是本地代码页简体中文环境是 936也就是 GBK。GBK 写出来的中文字节被 VS Code 以 UTF-8 去读就必然乱码。反过来也成立如果终端是 UTF-8但 VS Code 被某个历史文件带偏用了 GBK 或带 BOM 的 UTF-8 去读同样会花屏。所以排查的核心就一句话——让写入端和读取端都锁定 UTF-8并且是无 BOM 的 UTF-8。这里有个特别容易被忽略的坑Windows PowerShell 5.1 里你写-Encoding UTF8它实际生成的是UTF-8 with BOM。BOM 是文件开头三个不可见字节EF BB BF。VS Code 一般能识别但 Codex 再次读取、或者某些解析脚本读到开头这三个字节就会在中文前面冒出?或者一个奇怪的字符。这就是为什么很多人明明设了 UTF-8还是乱码——设是设了但设成了带 BOM 的版本。适合谁看这篇用 Codex 或类似终端 Agent 改中文项目的人、Windows 上被 PowerShell 编码折磨过的人、以及想把 Codex 的 API 通道统一到自己 Key 上的人。下面我按先修编辑器、再修终端、最后统一 API 通道的顺序走一遍每步都能直接复制。2. 把 VS Code 与 PowerShell 编码改到 TaoToken 工作流的前置准备在动手改配置之前先把两件事理清楚一是本地编码环境二是 Codex 的 API 通道。这两件事看着不相关其实都属于让 Codex 工作流稳定的一部分——编码决定文件内容对不对API 通道决定请求能不能稳定发出去。先说本地环境。你需要确认三样东西VS Code 版本近两年的都行、PowerShell 版本、以及 Codex 当前用的是哪个终端。PowerShell 版本直接在终端敲$PSVersionTable.PSVersion输出5.x说明是 Windows 自带的 Windows PowerShell旧版输出7.x说明是 PowerShell 7pwsh新版。这个区分很重要因为两者的 profile 路径不一样而且 5.1 的 UTF-8 行为有 BOM 坑。我的建议是能升 7 就升 7后面会讲为什么。再说 API 通道。Codex 这类工具默认可能走官方 endpoint但如果你想把请求统一到自己管理的 Key 上方便看用量、换模型、做团队共享就需要把 Base URL 指到一个兼容 OpenAI 协议的网关。TaoToken 提供的就是这样一个统一入口官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 根地址是https://taotoken.net/api。你需要在控制台里建一个 API Key然后把它填进 Codex 的配置。这里要强调一点编码问题和 API 通道是两件独立的事。乱码是本地字节层面的问题换 API 通道不会修好乱码但把通道统一之后你的 Codex 工作流改文件、跑命令、调模型都在一个可控环境里排查问题时变量更少。所以顺序上我建议先修编码确认中文正常了再去接通道。前置准备清单确认 PowerShell 版本决定用哪个 profile 路径确认 VS Code 已安装能打开settings.json在 TaoToken 控制台创建一个 API Key后面接通道要用准备一个含中文的测试文件比如utf8_test.txt用来复现和验证关于 Key 的获取进控制台的 API Keys 页面新建即可地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。建完先复制保存页面刷新后一般不再完整显示。模型 ID 这块Codex 场景常用的是编码能力强的模型具体可用列表在文档里能查到接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。把这两块准备好下面就可以进入具体配置了。记住配置的目标是写入端 UTF-8 无 BOM 读取端 UTF-8 请求通道统一三者缺一乱码或连接问题就可能冒出来。3. 可复制的 settings.json 与 PowerShell UTF-8 配置这一节是全文最核心的部分所有片段都能直接复制。我按VS Code → PowerShell profile → 验证的顺序给。3.1 VS Code 的 settings.json 编码项打开 VS Code按Ctrl ,进设置右上角有个打开设置(json)图标点进去编辑settings.json。加入下面这几项{ files.encoding: utf8, files.autoGuessEncoding: true, files.eol: \n, terminal.integrated.defaultProfile.windows: PowerShell, terminal.integrated.profiles.windows: { PowerShell: { source: PowerShell, args: [-NoLogo] } } }逐项说明files.encoding设为utf8保证 VS Code 保存文件时默认用 UTF-8files.autoGuessEncoding打开后打开历史文件时会自动探测编码减少老文件花屏files.eol统一成\n避免跨平台换行符混乱后面两项是把集成终端默认指向 PowerShell方便 Codex 在一致的环境里跑命令。注意files.encoding的值是utf8而不是utf-8VS Code 认前者。如果你项目里已经有settings.json把这几项合并进去别整个覆盖。3.2 PowerShell profile 的 UTF-8 初始化先查 profile 路径$PROFILE典型输出Windows PowerShell 5.1C:\Users\用户名\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1PowerShell 7C:\Users\用户名\Documents\PowerShell\Microsoft.PowerShell_profile.ps1如果文件不存在先创建if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Force -Path $PROFILE }然后写入 UTF-8 初始化块。PowerShell 7 用户直接用这段$utf8Block chcp 65001 | Out-Null [Console]::InputEncoding [System.Text.UTF8Encoding]::new() [Console]::OutputEncoding [System.Text.UTF8Encoding]::new() $OutputEncoding [System.Text.UTF8Encoding]::new() $PSDefaultParameterValues[Out-File:Encoding] utf8 $PSDefaultParameterValues[Set-Content:Encoding] utf8 $PSDefaultParameterValues[Add-Content:Encoding] utf8 Add-Content -Path $PROFILE -Value $utf8Block -Encoding UTF8Windows PowerShell 5.1 用户要特别小心因为Add-Content -Encoding UTF8会写出带 BOM 的文件。用下面这段强制无 BOM 写入$utf8Block chcp 65001 | Out-Null [Console]::InputEncoding [System.Text.UTF8Encoding]::new() [Console]::OutputEncoding [System.Text.UTF8Encoding]::new() $OutputEncoding [System.Text.UTF8Encoding]::new() $PSDefaultParameterValues[Out-File:Encoding] utf8 $PSDefaultParameterValues[Set-Content:Encoding] utf8 $PSDefaultParameterValues[Add-Content:Encoding] utf8 $profileContent if (Test-Path $PROFILE) { $profileContent Get-Content -Path $PROFILE -Raw } if ($profileContent -notmatch Console::OutputEncoding) { $newContent $profileContent rn $utf8Block [System.IO.File]::WriteAllText($PROFILE, $newContent, (New-Object System.Text.UTF8Encoding($false))) }关键在最后一行New-Object System.Text.UTF8Encoding($false)参数$false表示不写 BOM。这就是 5.1 用户绕开 BOM 坑的办法。3.3 让配置生效并验证执行. $PROFILE或者直接关掉终端重开。然后验证中文测试 | Set-Content -Path .\utf8_test.txt Get-Content .\utf8_test.txt能正常打印中文测试就说明终端读写都是 UTF-8 了。再用 VS Code 打开这个utf8_test.txt如果显示正常说明编辑器端也对齐了。3.4 把 Codex 的 endpoint 接到 TaoToken编码修好后接通道。Codex 的配置通常放在用户目录下的配置文件中核心是三项Base URL、API Key、Model ID。以常见的config.toml形式为例model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后在环境变量里设置 Key$env:TAOTOKEN_API_KEY 你的Key如果你用的是auth.json形式部分 Codex 版本结构类似{ OPENAI_API_KEY: 你的Key, OPENAI_BASE_URL: https://taotoken.net/api }三件套对照表配置项值说明Base URLhttps://taotoken.net/api统一请求入口不加 UTMAPI Key控制台新建的 Key存环境变量或 auth.jsonModel ID如gpt-4o以文档可用列表为准配置完重启 Codex让它重新读取配置。这一步做完你的 Codex 请求就走统一通道了配合前面的编码修复整个工作流就稳了。4. 复现乱码并验证修复是否成功光配好还不够得能复现问题、再验证修复才算真的解决。这一节给你一套可重复的验证动作。4.1 先复现乱码在修复前或者故意把终端编码改回 GBK跑一次chcp 936 中文乱码复现 | Set-Content -Path .\gbk_test.txt然后用 VS Code 打开gbk_test.txt。如果 VS Code 的files.autoGuessEncoding没开你大概率会看到乱码。这就是 Codex 改文件乱码的同一原理——终端用 GBK 写编辑器用 UTF-8 读。4.2 修复后验证把编码切回 UTF-8chcp 65001 中文正常显示 | Set-Content -Path .\utf8_ok.txt Get-Content .\utf8_ok.txt再用 VS Code 打开utf8_ok.txt应该正常显示。接着做一次Codex 改文件的模拟让 Codex 在一个含中文的 Markdown 文件里追加一段中文保存后打开看是否正常。如果正常说明写入链路和读取链路都对齐了。4.3 检查 BOMBOM 是隐形杀手用这条命令检查文件开头有没有 BOM$bytes [System.IO.File]::ReadAllBytes(.\utf8_ok.txt) $bytes[0..2] -join ,如果输出是239,187,191说明有 BOM正常无 BOM 的 UTF-8 中文文件开头应该是中文字节不会是这三个值。发现 BOM 就用 3.2 节里 5.1 的无 BOM 写法重写 profile或者直接用 PowerShell 7。4.4 验证 API 通道编码验证完顺手验证通道。用 curl 或 PowerShell 发一个最小请求$headers { Authorization Bearer $env:TAOTOKEN_API_KEY Content-Type application/json } $body { model gpt-4o messages ({ role user; content 回复通道正常 }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body返回里有正常的中文回复说明 Key、Base URL、Model ID 三件套都对。如果报 401看下一节。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞的几个报错我按真实日志对照着讲。401 Unauthorized。最常见的原因是 Key 没生效或写错。检查顺序环境变量是否在当前终端会话里$env:TAOTOKEN_API_KEY能不能打印出来、Key 有没有多余空格、Base URL 是不是写成了带/v1的完整路径导致拼接重复。注意 Base URL 用https://taotoken.net/api具体路径由客户端拼。如果 Key 是在控制台新建的确认没被删除或过期。local proxy failed / connection refused。这类报错通常是本地网络或代理配置问题。先确认没有残留的代理环境变量干扰检查HTTP_PROXY、HTTPS_PROXY是否指向了一个不存在的本地端口。如果你之前配过本地转发工具关掉它再试。另外确认防火墙没拦 PowerShell 的出站请求。reading choices 相关报错类似cannot read property choices of undefined。这通常说明返回体不是预期的 JSON 结构可能是请求打到了错误的 endpoint或者返回了错误页。先看原始返回内容用Invoke-RestMethod时加-StatusCodeVariable或直接看异常信息。常见原因是 Base URL 拼错、模型 ID 不存在。对照文档确认模型 ID 拼写。OAuth 相关报错。部分 Codex 版本走 OAuth 登录流程如果你混用了 OAuth 和 API Key 两种认证会冲突。解决办法是二选一要么清掉 OAuth 缓存走 Key要么反过来。检查配置目录里有没有残留的 token 文件清掉后重启。中文仍然乱码但终端正常。这时候问题在文件本身带了 BOM或者 VS Code 用了错误的编码打开。用 4.3 的字节检查法确认 BOM用 VS Code 右下角的编码指示器确认当前文件编码点它选通过编码重新打开试 UTF-8。PowerShell 5.1 写入仍带 BOM。回到 3.2 节确认用的是[System.IO.File]::WriteAllText加UTF8Encoding($false)的写法而不是Add-Content -Encoding UTF8。这是 5.1 最坑的地方强烈建议升 PowerShell 7。排障时如果怀疑是通道问题可以去模型对话页面手动发一条消息对比地址https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。如果网页端正常、本地报错那问题在本地配置如果两边都报错看 Key 和额度。6. 把编码修复和 API 通道固定成日常习惯配置改完不是终点得让它变成习惯不然换个终端、重装系统又回到原点。第一把 PowerShell 7 设为 VS Code 集成终端的默认。在settings.json里指定pwsh路径这样 Codex 每次跑命令都在 UTF-8 环境里不用每次手动chcp。第二项目根目录放一个.editorconfig声明charset utf-8团队协作时大家编码一致root true [*] charset utf-8 end_of_line lf insert_final_newline true第三把 API Key 放环境变量而不是硬编码进配置文件避免提交到仓库。第四定期用 4.3 的字节检查法抽查关键中文文件尤其是 Codex 刚批量改过的。如果你长期用 Codex 做编码和 Agent 任务可以考虑用 Coding Plan 把用量和通道统一管理入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。接入细节和可用模型以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。Key 管理在https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。最后留一个我踩过的坑有次改完 profile 忘了. $PROFILE以为没生效折腾半天发现只是没重载。所以每次改完 profile先重载再验证别急着怀疑配置写错了。编码这事本质就是让写入端和读取端说同一种语言锁定 UTF-8 无 BOM问题就少一大半。