1. Windows 中文乱码的根源：五类工具各管各的编码

你在 Windows 上打开一个中文 txt，NotePad++ 里是「锟斤拷」，EditPlus 里是「????」，UltraEdit 里是一堆方块，记事本里干脆变成「文件」，浏览器打开本地 HTML 又变成「ä¸æ–‡」。这不是文件坏了，而是每个工具都在用自己的默认编码去猜文件内容。Windows 中文环境的默认代码页是 GBK（CP936），而你的文件很可能是 UTF-8 无 BOM，两边对不上，就乱码了。

我试过最省事的办法不是一个个改，而是先把「谁在用什么编码」列清楚，再逐工具把默认值钉死成 UTF-8。这篇就是一份可照着敲的排查清单，覆盖 NotePad++、EditPlus、UltraEdit、Windows 记事本和浏览器五类工具，每一步都给可复制的配置项和验证动作。适合经常在 Windows 上处理中文文本、写前端页面、改配置文件的人。

核心检索词先摆出来：Windows 记事本默认编码改成 UTF-8、NotePad++ 设置 UTF-8 无 BOM、EditPlus 默认编码配置、UltraEdit 代码页设置、浏览器强制 UTF-8 编码。这几个词你搜任何一个，本质都是同一件事——让工具别再用 ANSI 猜。

先说清楚一个概念，UTF-8 和「UTF-8 无 BOM」不是一回事。BOM 是文件开头三个字节 EF BB BF，Windows 记事本另存为 UTF-8 时会带上它，而很多 Linux 工具、PHP、Node 脚本读到 BOM 会出问题（比如输出多一个空行、JSON 解析失败）。所以下面配置里我会明确区分：给人看的文本用带 BOM 的 UTF-8 也行，给程序读的配置和代码一律用「UTF-8 无 BOM」。

还有一个坑：改完工具默认编码，旧文件不会自动变。你打开一个已经是 GBK 的文件，工具按 UTF-8 去解，照样乱。正确顺序是「先转换当前文件编码，再改默认编码」，这两步在下面每个工具里都会分开写。

2. 把 endpoint 与 settings 统一到 TaoToken 的前置准备

工具编码统一之后，还有一个经常被忽略的乱码来源：你从接口拿回来的文本本身编码就不对。比如用脚本请求一个大模型接口，返回的 JSON 里中文变成\u4e2d\u6587或者直接乱码，这时候你在 NotePad++ 里怎么调编码都没用，因为源头就错了。所以这一步先把请求侧统一。

TaoToken 是一个兼容 OpenAI 接口风格的模型调用入口，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 根地址是 https://taotoken.net/api 。它的作用是让你用同一套 Base URL 和 Key，去调用不同模型，省得每个模型记一套地址。对这篇的主题来说，关键点是：请求和响应都按 UTF-8 处理，你本地工具也设成 UTF-8，两边就对齐了。

前置准备分三件事。

第一，拿 Key。进控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面创建一个 Key，复制出来。这个 Key 只显示一次，丢了就重建。API Keys 直达： https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

第二，确认 Base URL。所有请求走 https://taotoken.net/api ，注意结尾不要多加/v1之外的斜杠，不同客户端对路径拼接规则不一样，写错会 404。文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

第三，想清楚你要在哪用。如果你只是偶尔验证模型输出，用模型对话页面最快： https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。如果你要长期写代码、跑 Agent，建议开 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。Claude Code 用户看这个接入页： https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude-code-anthropic&utm_campaign=rewrite 。

这里要提醒一句：TaoToken 是接口调用入口，不是编辑器替代品。它不会帮你改 NotePad++ 的编码设置，它管的是「请求发出去、响应收回来」这一段。本地工具的编码，还是得按第 3 节一个个配。

为什么要把这两件事放一起？因为乱码排查最怕「以为改了其实没改」。你本地工具设了 UTF-8，但请求回来的响应是 GBK 字节流，你保存成 .txt 再打开还是乱。反过来，请求侧是 UTF-8，本地工具默认 ANSI，一样乱。两头都钉死 UTF-8，才能一次到位。

3. 五类工具的可复制 UTF-8 配置项

这一节是全文最该收藏的部分，每个工具给「当前文件转换」和「默认编码设置」两组操作，配置片段可直接复制。

3.1 NotePad++ 设置 UTF-8 无 BOM

当前文件转换：菜单「编码」→「转为 UTF-8 编码」（不带 BOM）。如果你要的是带 BOM，选「转为 UTF-8-BOM 编码」。判断标准：给程序读选前者，给 Excel 打开选后者。

改默认编码，让它以后新建文件就是 UTF-8：菜单「设置」→「首选项」→「新建」→ 编码选「UTF-8（无 BOM）」，同时把「默认语言」设成你常用的。老版本路径是「设置」→「首选项」→「新建/默认目录」。

如果你要批量处理，NotePad++ 支持宏和 PythonScript 插件，但更稳的是命令行。下面这段用 Python 把目录下所有 .txt 从 GBK 转 UTF-8，可复制：

import os src_dir = r"D:\work\texts" for name in os.listdir(src_dir): if not name.lower().endswith(".txt"): continue path = os.path.join(src_dir, name) with open(path, "r", encoding="gbk", errors="replace") as f: content = f.read() with open(path, "w", encoding="utf-8", newline="\n") as f: f.write(content) print("converted:", name)

注意errors="replace"只是防止中途崩，真正干净的文件不该有替换字符，转完要抽查。

3.2 EditPlus 默认编码配置

当前文件转换：菜单「文档」→「文件编码」→「转换编码」→ 在 Select encoding 下拉框选 UTF-8。一般到这一步就好了，如果还乱，做第二步。

改默认编码：菜单「工具」→「首选项」→ 左侧面板选「文件」→「默认编码」→ 选 UTF-8。这里有个细节，EditPlus 的「默认编码」和「打开文件时自动检测」是两回事，建议把自动检测也打开，否则打开无 BOM 的 UTF-8 文件它可能按 ANSI 解。

EditPlus 的配置文件是uedit32.ini风格吗？不是，EditPlus 用的是自己的.ini，一般在安装目录或%APPDATA%\EditPlus。如果你要脚本化部署，可以直接改 ini 里的编码项，但版本差异大，不如手动点一次稳。

3.3 UltraEdit 代码页设置

当前文件转换：菜单「高级」→「设置代码页」→ 选 UTF-8。或者用「文件」→「转换」→「UTF-8 转 ASCII/ANSI」的反向操作。

改默认：打开 UltraEdit 安装路径下的uedit32.ini（64 位是uedit64.ini），如果没有就新建，写入：

[Settings] Detect UTF-8 String = 0

Detect UTF-8 String = 0的意思是关闭自动检测 UTF-8 字符串，避免它把 GBK 文件误判成 UTF-8。这个值设 0 还是 1 取决于你的文件构成，纯 UTF-8 环境设 1 更省事，混合环境设 0 更安全。

UltraEdit 还有个「代码页」概念，在「视图」→「代码页」里能看到当前用的是 936（GBK）还是 65001（UTF-8）。65001 就是 UTF-8 的代码页编号，记住这个数字，很多 Windows 工具都用它。

3.4 Windows 记事本默认 UTF-8

记事本本身没有「默认编码」设置项，得靠模板文件 + 注册表。

第一步，在C:\Windows\ShellNew目录下（没有就新建）创建一个空白 txt，另存为时编码选 UTF-8，命名为UTF8.txt。

第二步，按Win + R输入regedit打开注册表，定位到：

HKEY_CLASSES_ROOT\.txt\ShellNew

右键右侧空白区，新建「字符串值」，命名为FileName，双击把值设为UTF8.txt。

第三步，定位到：

HKEY_CURRENT_USER\Software\Microsoft\Notepad

把fSavePageSettings和fSaveWindowPositions两项的值改成 1，不存在就新建 DWORD。

这套操作的效果是：以后你在资源管理器右键「新建」→「文本文档」，生成的就是 UTF-8 编码。但注意，如果你是从开始菜单直接启动 notepad.exe 再新建，模板不生效，还是 ANSI。这是记事本的老毛病，改不掉，只能养成「右键新建」的习惯。

3.5 浏览器强制 UTF-8

Chrome：右上角三点 →「更多工具」→「编码」→ 选 Unicode（UTF-8）。新版 Chrome 把编码菜单藏得比较深，如果找不到，在设置里搜「字体」，进「自定义字体」，把默认编码设为 UTF-8。

Firefox：新版没有菜单栏，按 Alt 调出 →「查看」→「字符编码」→ 选 Unicode。或者在「工具」→「选项」→「内容」→「字体和颜色」→「高级」→ 字体编码里设。

IE / Edge 旧版：页面右键 →「编码」→ Unicode（UTF-8），或按 Alt →「查看」→「编码」。

浏览器这块要补一句：本地 HTML 文件乱码，最根本的解法是在 HTML 里写<meta charset="utf-8">，而不是靠浏览器菜单临时切。菜单切换只对当前页有效，刷新就回去了。

4. 验证请求与成功结果：确认不再乱码

配置改完必须验证，不然你永远不知道是真好了还是碰巧。

本地文件验证：新建一个 txt，输入「中文测试 你好世界」，保存。用十六进制工具看开头，UTF-8 无 BOM 应该是E4 B8 AD（「中」的 UTF-8 编码），带 BOM 则是EF BB BF E4 B8 AD。如果看到D6 D0，那是 GBK，说明没转成功。

跨工具验证：同一个文件，用 NotePad++、EditPlus、UltraEdit、记事本分别打开，四个都显示正常中文，才算过关。任何一个乱，回去查那个工具的默认编码。

请求侧验证：用 curl 打一次接口，确认响应是 UTF-8。下面这段可复制，把 Key 换成你自己的：

curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "用中文回复：编码测试"}] }'

关键看两点：请求头Content-Type: application/json默认按 UTF-8 解析；响应里的中文应该是正常汉字，不是\uXXXX转义（转义也能用，但说明客户端没解）。如果你在 Windows 的 cmd 里跑 curl，cmd 默认代码页是 936，中文可能显示乱，建议在 PowerShell 里跑，或者把输出重定向到文件再用 NotePad++ 打开看。

成功结果长这样：终端里直接看到「编码测试成功」这类中文，保存到文件后用第 3 节配好的工具打开，中文完整。如果终端乱但文件正常，那是终端的问题，不是接口的问题，别改错地方。

再补一个 JSON 配置片段，很多客户端（比如 Cline、Continue、Codex 类工具）用这种结构，路径和字段名照抄：

{ "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "model": "gpt-4o-mini", "encoding": "utf-8" }

注意baseUrl结尾不要带/v1，具体路径由客户端拼。model填你在模型列表里看到的 ID。encoding字段不是所有客户端都认，认的会用它处理响应，不认的忽略即可。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

乱码排查里混着接口报错，这两类问题经常一起出现，分开看。

401 Unauthorized：Key 错了、过期了、或者请求头没带对。检查Authorization: Bearer sk-xxx格式，Bearer 后面有一个空格。如果 Key 是从网页复制的，注意别把首尾空格带进去。401 和编码无关，但很多人以为是乱码，其实是根本没请求成功。

local proxy failed：客户端配了本地代理但代理没起来，或者代理地址写错。这个报错和网络环境有关，检查客户端里的代理设置，如果不需要代理就关掉。注意，这里说的是客户端自身的代理配置项，不是让你去搭什么通道。

reading choices 报错：通常是响应结构和你客户端预期的不一样。比如客户端按choices[0].message.content取，但返回的是流式 chunk，或者返回了错误对象。先看原始响应长什么样，用第 4 节的 curl 打一次，确认返回结构，再对客户端的解析配置。

OAuth 相关报错：某些客户端（比如 Claude Code 类）默认走 OAuth 登录，你要改成 API Key 模式。在配置里把认证方式从 OAuth 切成 API Key，填 Base URL + Key + Model ID 三件套。三件套缺一不可：

• Base URL：https://taotoken.net/api
• Key：控制台创建的sk-开头字符串
• Model ID：模型列表里的准确 ID，大小写敏感

如果你用 CC Switch、Cline MCP 或 Codex 的auth.json，这三个值都要写全。auth.json里字段名可能是base_url、api_key、model，按客户端文档来，别自己造字段名。

编码类报错单独说：如果你看到「invalid byte sequence」「UnicodeDecodeError」，那是文件编码和读取编码不匹配。Python 里显式指定encoding="utf-8"，别依赖系统默认。Windows 上open()不写 encoding 会用 GBK，这是最常见的坑。

6. 把编码和接口一起管起来：长期维护建议

配置改一次不够，换机器、重装系统、团队协作都会打回原形。几个实用做法。

把C:\Windows\ShellNew\UTF8.txt和注册表那两项导出成.reg文件，重装后双击导入。导出方法：注册表里右键HKEY_CLASSES_ROOT\.txt\ShellNew→ 导出。这样记事本默认编码不用重配。

团队协作时，在项目根目录放一个.editorconfig，让支持的编辑器自动统一编码：

root = true [*] charset = utf-8 end_of_line = lf insert_final_newline = true

NotePad++ 需要装 EditorConfig 插件才认，VS Code、JetBrains 系原生支持。这个文件比口头约定靠谱。

接口侧，把 Base URL 和 Key 写进环境变量，别硬编码在脚本里。PowerShell 里：

$env:TAOTOKEN_BASE_URL = "https://taotoken.net/api" $env:TAOTOKEN_API_KEY = "sk-你的Key"

脚本里读os.environ["TAOTOKEN_API_KEY"]，换 Key 不用改代码。长期跑编码任务和 Agent 的话，Coding Plan 比按次调用省心，地址在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。

最后一条经验：遇到乱码先别急着改编码，先用十六进制看一眼文件头。EF BB BF是 UTF-8 BOM，FF FE是 UTF-16 LE，D6 D0开头大概率是 GBK。看清楚再动手，比来回试快得多。工具默认编码、文件实际编码、请求响应编码，这三者对齐了，Windows 下的中文乱码基本就绝迹了。