1. Trae 里跑 Python中文为什么变成“锘”和问号你在 Trae 里写了一段再普通不过的 Pythonprint(你好世界) print(订单创建成功)点下 Code Runner 的三角按钮输出窗口却给你甩回来一堆锘、?、ä½ å¥½之类的东西。代码没错逻辑没错就是中文不认人。这个问题在 Trae 里出现的频率不低尤其是 Windows 环境加 Code Runner 插件的组合几乎每个刚上手的人都会撞一次。先把结论说清楚Trae 中 Python 中文乱码本质是编码链路里有一环没对齐 UTF-8。这条链路上有四个角色——Python 源文件本身的编码、Python 解释器读写标准输出时用的编码、Code Runner 拼出来的执行命令、以及终端/输出窗口的显示编码。只要其中任意一个还在用 GBK 或系统默认代码页中文就会在某一环被“翻译错”最终显示成乱码。Code Runner 的坑在于它默认不是直接在系统终端里跑而是把命令丢进一个 OUTPUT 面板执行这个面板的编码行为和你手动开终端不完全一样。再加上 Windows 上 Python 的sys.stdout默认编码经常跟着系统区域设置走可能是 cp936print出去的中文在写入管道时就已经变形了。所以这篇不聊虚的直接给你一条能复制的排查链路先定位是哪一环出问题再用PYTHONIOENCODING把解释器输出锁死成 UTF-8最后改settings.json让 Code Runner 每次执行都带上这个变量。顺带说一句如果你平时还要在 Trae 里接模型做代码补全或对话TaoToken 可以作为统一的 Key/API 通道把模型调用和本地脚本调试放在同一套配置习惯里省得来回换。适合谁看在 Trae 里用 Code Runner 跑 Python、输出中文就乱码的人想搞清楚PYTHONIOENCODING到底管什么的人以及希望把编辑器配置一次改好、以后不再反复踩坑的人。2. 动手前先把 TaoToken 的 Key 和通道准备好这一节不是必须的——你完全可以只改settings.json就解决乱码。但既然场景里提到了 TaoToken 统一 Key我就把它放在前面说清楚因为后面验证脚本时我会顺带演示一个调用模型接口的小例子那时候需要用到 Key。TaoToken 在这里的角色是统一的 API 通道你注册一次、拿一个 Key就能在 Trae 里通过它访问不同的模型不用为每个模型单独配一套地址和密钥。对于经常在编辑器里做代码问答、让模型帮忙解释报错的人来说这种“一个 Key 走天下”的方式确实省事。操作路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面创建一个新 Key。这个 Key 就是后面所有调用的凭证复制出来先存好别直接贴在会提交到 Git 的文件里。如果你只是想先跑通模型对话看看效果可以直接用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 在网页里发几条消息确认 Key 能用、通道是通的。这一步不写代码纯点选适合先建立信心。接口地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数是干净的 API 根路径。至于 Coding Plan 这类长期编码场景可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合把模型能力嵌进日常写代码的流程里而不是一次性问答。提示Key 属于敏感信息。在 Trae 里配置时优先用环境变量或单独的本地配置文件不要硬编码进settings.json这种可能被同步或分享的文件。准备好 Key 之后我们回到乱码本身。下面进入真正的配置环节。3. 可复制的 settings.json 配置让 Code Runner 带上 PYTHONIOENCODINGTrae 的设置文件和 VS Code 同源都是settings.json。打开方式命令面板CtrlShiftP里搜 “Open User Settings (JSON)”或者直接找设置界面的右上角那个“打开设置(JSON)”图标。核心思路是改 Code Runner 的执行命令模板让它在调用 Python 之前先设置PYTHONIOENCODINGutf8并且加上-u关闭缓冲。下面这段可以直接复制注意它是 JSON别多逗号少引号{ code-runner.executorMap: { python: set PYTHONIOENCODINGutf8 python -u }, code-runner.runInTerminal: true, code-runner.clearPreviousOutput: true, files.encoding: utf8, files.autoGuessEncoding: false }逐项解释一下别照抄完不知道为什么code-runner.executorMap里的python这一行是 Code Runner 执行.py文件时实际拼出来的命令。set PYTHONIOENCODINGutf8是 Windows 的写法作用是给这次进程设置环境变量强制 Python 的标准输入输出用 UTF-8。表示前一条成功后再执行后面。python -u里的-u让 stdout/stderr 不缓冲输出实时刷出来也避免缓冲层再做一次编码转换。code-runner.runInTerminal设为true很关键。默认 Code Runner 在 OUTPUT 面板跑那个面板的编码行为不好控制改成在终端里跑终端本身的编码更透明配合PYTHONIOENCODING基本就稳了。files.encoding设成utf8保证 Trae 读写源文件时用 UTF-8。files.autoGuessEncoding关掉避免它“自作聪明”猜成 GBK。如果你用的是 macOS 或 Linuxset要换成export命令变成{ code-runner.executorMap: { python: export PYTHONIOENCODINGutf8 python -u } }改完保存CtrlS。这里有个容易忽略的点settings.json里如果已经有code-runner.executorMap不要重复写两个同名键合并进去就行否则后面的会覆盖前面的。另外如果你不想动全局设置只想给当前项目单独配可以在项目根目录建.vscode/settings.json内容一样。Trae 会优先读项目级配置。4. 验证请求跑一个带中文的脚本确认输出干净配置改完必须验证不然你不知道是配置生效了还是碰巧好了。新建一个test_encoding.py# -*- coding: utf-8 -*- import sys print(你好世界) print(当前 stdout 编码:, sys.stdout.encoding) print(订单创建成功金额 199.00)第一行是编码声明虽然 Python 3 默认源文件就是 UTF-8但写上不亏明确意图。第二行打印sys.stdout.encoding这是关键——如果输出是utf-8说明PYTHONIOENCODING生效了如果还是cp936或gbk说明配置没被 Code Runner 读到。用 Code Runner 跑快捷键一般是 CtrlAltN观察终端输出。正常应该是你好世界 当前 stdout 编码: utf-8 订单创建成功金额 199.00如果sys.stdout.encoding显示utf-8且中文正常恭喜链路通了。再补一个更贴近实际的验证写一段调用 TaoToken 接口的脚本顺便确认 Key 和编码都不打架。用requests举例import os import requests api_key os.environ.get(TAOTOKEN_API_KEY) url https://taotoken.net/api/v1/chat/completions headers { Authorization: fBearer {api_key}, Content-Type: application/json } payload { model: gpt-4o-mini, messages: [ {role: user, content: 用一句中文解释什么是编码} ] } resp requests.post(url, headersheaders, jsonpayload, timeout30) data resp.json() print(模型回复, data[choices][0][message][content])运行前先把 Key 放进环境变量Windows 下可以临时set TAOTOKEN_API_KEY你的Key或者在 Trae 的终端配置里注入。这段脚本同时验证了两件事中文请求体发出去没乱码中文回复打出来也没乱码。如果模型回复的中文正常显示说明从网络到终端的整条编码链路都是干净的。注意上面用的模型名只是示例实际可用模型以 TaoToken 控制台或文档里列出的为准。接口路径和鉴权方式参考接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 别照搬别家平台的格式。5. 本篇常见错排查改了还是乱码怎么办配置照抄了重启了还是乱码按下面顺序排查基本能定位到具体哪一环。第一种sys.stdout.encoding还是 cp936。说明PYTHONIOENCODING没传进去。检查settings.json里code-runner.executorMap的键名是不是python小写Trae 对大小写敏感。再检查是不是项目级settings.json覆盖了用户级两处都看一眼。还有一种情况你装了 Python 插件它自带的运行按钮不走 Code Runner走的是插件自己的执行逻辑那executorMap就不生效。确认你是用 Code Runner 的入口在跑。第二种终端里中文正常OUTPUT 面板里乱码。这就是code-runner.runInTerminal没设成true。OUTPUT 面板的编码不好控直接改成终端运行最省事。第三种源文件本身存成了 GBK。打开 Trae 右下角的编码指示器看当前文件是不是 UTF-8。如果是 GBK用“通过编码重新打开”再“以 UTF-8 保存”。files.autoGuessEncoding设成false可以防止它下次又猜错。第四种Windows 终端本身的代码页是 936。在终端里敲chcp看输出。如果是 936可以临时chcp 65001切到 UTF-8。但更推荐的做法是让PYTHONIOENCODING兜底因为改代码页只影响当前终端会话换个窗口又回去了。第五种print的内容来自文件读取文件是 GBK。这时候乱码不在输出环节在读取环节。读文件时显式指定encodingutf-8或者用errorsreplace先看个大概。别指望PYTHONIOENCODING能修读取编码它只管标准输入输出。第六种命令里的在某些 shell 下不认。如果你把默认终端换成了 PowerShell 或 Git Bashset VARvalue cmd的语法可能不对。PowerShell 里应该用$env:PYTHONIOENCODINGutf8; python -u。确认你的默认终端是什么再选对应写法。排查时有个通用技巧在脚本开头加一行print(sys.stdout.encoding, sys.getdefaultencoding(), sys.getfilesystemencoding())三个编码一次打出来对照着看是哪一层没对齐。6. 把配置固化下来下次直接复用乱码这种事修一次就该让它永远别再出现。我的做法是把settings.json里那几行当成模板换电脑、重装 Trae 时直接贴回去。code-runner.executorMap加上PYTHONIOENCODING和-urunInTerminal打开files.encoding锁 UTF-8这四件事做完Trae 里跑 Python 的中文输出基本不会再翻车。如果你在 Trae 里还要接模型做代码辅助Key 的管理也建议一次配好。TaoToken 的 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以创建和管理密钥接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有具体的请求格式。把 Key 放进环境变量脚本里用os.environ读既安全又不用每次改代码。最后留一个我自己的习惯每次新建 Python 项目先在根目录放一个.vscode/settings.json把编码相关的配置写死。这样不管全局设置怎么变项目内的行为是一致的。中文乱码说到底是个配置一致性问题配置对齐了它就只是个一次性动作而不是每次都要重新查的麻烦。