1. 为什么 Cursor AI 总把 Python 文件改成 GBK在 Windows 上写 Python最让人抓狂的不是缩进而是某天打开文件突然满屏「锟斤拷」。我遇到过好几次明明昨天还是好好的 UTF-8今天 Cursor 保存一下中文注释全变问号print(你好)直接抛UnicodeEncodeError。排查半天才发现文件编码被悄悄改成了 GBK。这个问题的根源有三层。第一层是 Windows 中文版的系统默认编码长期是 GBK代码页 936很多编辑器在「猜」编码时会优先往系统默认靠。第二层是 Cursor 基于 VS Codefiles.autoGuessEncoding默认行为在某些版本里会误判尤其是文件里中文不多、或者混了少量特殊符号时它会把 UTF-8 猜成 GBK。第三层最隐蔽AI 补全或格式化在重写文件时如果当前会话的编码状态是 GBK它保存回去就顺着 GBK 写了你根本没点过「另存为」。结果就是源码文件本身变成 GBKPython 解释器在 Windows 下又默认用 GBK 去读看起来「能跑」但一旦换到 Linux 服务器、Docker 容器、或者 CI 流水线立刻乱码或报错。更麻烦的是 Git diff 会显示整文件改动代码评审直接爆炸。所以这件事要分两头治一头是让 Cursor 永远以 UTF-8 保存另一头是让 Windows 上的 Python 运行时也强制 UTF-8。两头都对齐乱码才不会再冒出来。下面我会把配置骨架、TaoToken 的统一接入方式、以及编码自检脚本一次性给全你照着复制就能用。2. TaoToken 前置统一 Key 与 API 通道在动手改编码之前先说清楚为什么这里要提 TaoToken。Cursor 的 AI 能力补全、Chat、Agent 改代码需要调用模型接口如果你在多个工具、多个项目里各配一套 Key 和 Base URL很容易出现「这个项目能补全、那个项目报 401」的混乱。TaoToken 做的事情就是把这些调用收敛到一个统一入口一个 Key、一个 API 地址Cursor、脚本、命令行工具都走同一条通道。它的接入地址很固定官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址https://taotoken.net/api 这个不加 UTM直接填进配置对 Cursor 来说你需要在设置里把 OpenAI 兼容的 Base URL 指向https://taotoken.net/api然后把 Key 填进去。这样 AI 改代码时走的是同一条稳定通道不会因为某个第三方端点抽风而中途失败——中途失败恰恰是编码被写坏的常见诱因因为写入过程被打断编辑器可能用当前猜测的编码落盘。如果你还没建 Key去控制台生成一个API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite想先验证模型通不通可以用模型对话页面发一条测试消息模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你打算长期用 Cursor 做编码、跑 Agent 任务建议直接看 Coding Plan额度模型更适合高频调用Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入文档在这里遇到参数问题对着查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite注意TaoToken 只是模型调用的统一通道它不替代 Cursor 编辑器本身也不负责文件编码。编码问题仍然要靠下面的 settings.json 和 .editorconfig 来解决两者是配合关系。3. 可复制配置settings.json 与 .editorconfig这一节是全文的核心配置分三块Cursor 编辑器层、项目层、Python 运行时层。三层都锁死 UTF-8AI 就没有机会把文件写成 GBK。3.1 Cursor 的 settings.json按Ctrl Shift P搜索Preferences: Open Settings (JSON)打开后把下面这段合并进去。如果已有同名项直接覆盖{ files.encoding: utf8, files.autoGuessEncoding: false, files.eol: \n, editor.formatOnSave: false, editor.defaultFormatter: null, [python]: { editor.formatOnSave: false, editor.defaultFormatter: null }, files.trimTrailingWhitespace: false }逐项解释一下为什么这么设files.encoding设为utf8这是硬性保存编码新建和保存都走 UTF-8不再跟随系统 GBK。files.autoGuessEncoding设为false是关键中的关键。开着它Cursor 会「猜」编码中文少的时候经常猜成 GBK。关掉之后它老老实实按files.encoding来。files.eol设为\n统一换行符避免 Windows 的 CRLF 和 Linux 的 LF 混用导致 Git 整文件 diff。editor.formatOnSave和editor.defaultFormatter关掉是因为格式化器在重写文件时可能触发编码转换尤其是某些 Python 格式化插件。先关掉等编码稳定了再按需开。files.trimTrailingWhitespace关掉是因为它也会在保存时重写文件内容属于「多一次写入就多一次编码风险」的操作。3.2 项目级 .editorconfig在项目根目录建一个.editorconfig这样即使换机器、换编辑器编码规则也跟着项目走root true [*] charset utf-8 end_of_line lf insert_final_newline true trim_trailing_whitespace false indent_style space indent_size 4 [*.py] charset utf-8charset utf-8是 EditorConfig 标准写法Cursor、VS Code、PyCharm 都认。root true表示这是项目根不再往上找配置。3.3 Python 文件头声明在每个 Python 文件第一行加编码声明。虽然 Python 3 默认就是 UTF-8但显式写出来能防止某些工具误判# -*- coding: utf-8 -*-如果你有大量文件要批量加可以用这个脚本先备份再跑import pathlib header # -*- coding: utf-8 -*-\n for p in pathlib.Path(.).rglob(*.py): text p.read_text(encodingutf-8) if not text.startswith(# -*- coding): p.write_text(header text, encodingutf-8) print(fadded: {p})3.4 Windows 运行时强制 UTF-8编辑器层搞定后还要让 Python 解释器在 Windows 下也用 UTF-8。在 PowerShell 里执行一次setx PYTHONUTF8 1执行完要重启终端才生效。这个环境变量会让 Python 进入 UTF-8 模式open()默认编码、sys.stdout编码都变成 UTF-8不再用系统的 GBK。如果你不想改全局环境变量也可以在代码里显式指定import sys import io sys.stdout io.TextIOWrapper(sys.stdout.buffer, encodingutf-8) sys.stderr io.TextIOWrapper(sys.stderr.buffer, encodingutf-8)但更推荐用PYTHONUTF8一次设置全局生效代码里不用加这些样板。4. 验证请求与成功结果配置写完必须验证不然你永远不知道到底生效没有。验证分三步查文件编码、跑 Python 输出、走一次 TaoToken 请求确认 AI 通道正常。4.1 检测文件真实编码Windows 下可以用 Python 的charset-normalizer或chardet来检测from charset_normalizer import from_path result from_path(test_encoding.py).best() print(result.encoding, result.percent_coherence)如果输出是utf_8且置信度高说明文件确实是 UTF-8。如果输出gbk或cp936说明还有文件没转过来。更简单的方式是用 Cursor 右下角的编码栏点开看当前文件显示的是UTF-8还是GBK。显示 UTF-8 就对了。4.2 运行验证脚本建一个test_encoding.py内容如下# -*- coding: utf-8 -*- import sys print(文件编码声明: utf-8) print(标准输出编码:, sys.stdout.encoding) print(文件系统编码:, sys.getfilesystemencoding()) print(中文测试: 你好世界) print(特殊符号: → ★ ①) with open(output_test.txt, w, encodingutf-8) as f: f.write(写入中文测试\n) with open(output_test.txt, r, encodingutf-8) as f: print(读回内容:, f.read().strip())在 PowerShell 里跑python test_encoding.py期望输出文件编码声明: utf-8 标准输出编码: utf-8 文件系统编码: utf-8 中文测试: 你好世界 特殊符号: → ★ ① 读回内容: 写入中文测试如果标准输出编码显示cp936或gbk说明PYTHONUTF8没生效检查是否重启了终端或者用echo $env:PYTHONUTF8确认变量存在。4.3 验证 TaoToken 通道用 curl 发一条最小请求确认 Key 和 Base URL 配对了curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复通道正常}] }返回里有正常内容说明通道没问题。这一步的意义在于确认 AI 调用不会中途失败从而避免「写入被打断导致编码回退」的连锁问题。4.4 让 Cursor AI 改一次代码最后做一次实战验证在 Cursor 里打开一个 UTF-8 的 Python 文件让 AI 帮你加一个函数保存后检查右下角编码是否还是 UTF-8再跑一次脚本确认输出正常。如果编码没变、输出没乱整套配置就算落地了。5. 本篇常见错排查配置过程中最容易踩的坑我按出现频率排一下。编码栏显示 UTF-8 但文件实际是 GBK。这是最坑的一种。Cursor 的编码栏显示的是「当前会话认为的编码」不代表文件字节真的是 UTF-8。用charset-normalizer检测字节或者用十六进制工具看中文部分。如果字节是 GBK 但显示 UTF-8说明文件需要真正转码不是改个显示就行。setx PYTHONUTF8 1执行了但没生效。两个原因一是没重启终端环境变量只在新的进程里生效二是你用的是 Cursor 内置终端它可能继承的是启动时的环境。关掉 Cursor 完全重启一次再开终端验证。转码后文件开头多了 BOM。有些工具转 UTF-8 时会加 BOMEF BB BFPython 3 能处理但某些场景会出问题。用utf-8-sig读、utf-8写可以去掉 BOMtext open(old.py, encodingutf-8-sig).read() open(new.py, w, encodingutf-8).write(text)Git 显示整文件改动。通常是换行符或编码变了。检查.gitattributes加上* textauto eollf *.py text eollf然后git add --renormalize .重新规范化一次。AI 补全后中文变问号。说明保存时编码回退了。检查files.autoGuessEncoding是否真的关掉了以及有没有插件覆盖了这个设置。在 Cursor 设置里搜autoGuessEncoding确认值为false。批量转码脚本跑一半报错。多半是遇到非 UTF-8 文件。加个异常捕获跳过读不了的文件import pathlib for p in pathlib.Path(.).rglob(*.py): try: text p.read_text(encodingutf-8) except UnicodeDecodeError: print(fskip (not utf-8): {p}) continue p.write_text(text, encodingutf-8)终端输出中文乱码但文件没问题。这是终端本身的编码问题。PowerShell 里执行chcp 65001切到 UTF-8 代码页或者在 Cursor 设置里把终端编码固定为 UTF-8。6. 把编码和通道一起锁死整套流程走下来你会发现编码问题从来不是单点问题而是「编辑器保存编码 项目配置 运行时编码 AI 调用稳定性」四件事的叠加。任何一环松动乱码就会从缝里钻出来。我的建议是把这套配置固化下来settings.json和.editorconfig提交到项目仓库PYTHONUTF8写进你的 Windows 环境初始化脚本TaoToken 的 Key 和 Base URL 统一配一次Cursor、脚本、命令行都复用。这样换机器、换项目、换同事编码规则都跟着走不用每次重新踩坑。如果你还没配 TaoToken 通道从 API Keys 页面建一个 Key填进 Cursor 的 OpenAI 兼容配置里Base URL 用https://taotoken.net/api。通道稳定了AI 改代码不会中途断编码回退的概率也会明显下降。长期做编码和 Agent 任务的话Coding Plan 的额度模型更划算可以顺手看一下。最后留一个自检习惯每次让 AI 大改代码之后跑一遍第 4 节的验证脚本确认输出编码还是 UTF-8。三十秒的事能省掉后面半小时的乱码排查。