1. WSL 里 cc-switch 满屏方块问题到底出在哪如果你在 Windows 上跑 WSLUbuntu 里装了 cc-switch 这类图形化工具打开一看菜单和按钮全是方块、问号或者乱码那基本不是 cc-switch 本身的锅。cc-switch 只是个壳它把文字交给系统字体和 locale 去渲染系统这边没配好中文界面自然就花了。我一开始也以为是软件 bug重装了两遍没用。后来才想明白WSL 的 Ubuntu 默认是纯英文环境既没有生成 zh_CN.UTF-8 这个 locale也没装中文字体。图形界面要显示中文得同时满足两个条件——locale 告诉程序「现在用中文编码」字体告诉系统「这个汉字长什么样」。缺一个就是方块。这篇就按排障视角来写。你手上如果已经有一份中文环境配置脚本装 language-pack-zh-hans、locale-gen zh_CN.UTF-8、装 fonts-wqy 系列字体、fc-cache -fv那正好我们不光要跑它还要用 Codex 帮你逐行验证它到底有没有生效。因为脚本跑完不等于配置成功LANG 有没有真写进 ~/.bashrc、字体包装全没有、fc-cache 刷新成没成功这些都得查。这里 Codex 的角色是「帮你读脚本、跑命令、看结果」的排查助手而它需要一个稳定的模型通道。TaoToken 就是干这个的给 Codex 提供可用的模型调用和用量统计你每让它分析一段脚本、每跑一次建议命令都会消耗 Token账目在后台看得清清楚楚。下面从拿 Key 开始一步步走完。2. 先给 Codex 接上 TaoToken 的模型通道Codex 要能帮你分析脚本前提是它能正常发请求。默认它连的是官方地址国内网络下经常超时或者连不上这时候换成 TaoToken 的通道最省事。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册登录进控制台创建一个 API Key。这个 Key 就是你后面填进 Codex 的凭证复制好别丢。创建完 Key重点在 Base URL 的填法。Codex 里配置模型地址时填https://taotoken.net/api注意这里不要带 /v1。很多人习惯性写成https://taotoken.net/api/v1结果请求 404 或者路径拼接错乱报错信息还特别含糊查半天查不出来。TaoToken 的接入地址就是到/api为止Codex 自己会补后面的路径。配置项对照如下配置项填写内容说明Base URLhttps://taotoken.net/api结尾不带 /v1API Key控制台创建的 Key形如 sk- 开头模型名按控制台可用列表填用于脚本分析用量统计控制台查看每次分析/命令都计 Token填完之后Codex 的请求就走 TaoToken 通道了。这里要说明白TaoToken 只负责提供模型通道和用量记录它不碰你的脚本、不改你的系统真正读脚本、给命令、判断结果的是 Codex。所以乱码修不修得好取决于 Codex 分析得对不对以及你有没有照着执行。如果你后面要长期用 Codex 做编码和 Agent 类任务可以考虑 Coding Plan用量更划算只是临时排查这一次按量用就行。3. 把中文环境脚本原样贴给 Codex 逐行查Key 配好接下来就是核心操作把那份 Ubuntu 中文环境脚本整段贴给 Codex让它逐行检查。不要自己先改先让它看原样这样它才能指出哪一行可能有问题。脚本大致长这样你可以对照自己手上的版本#!/bin/bash echo WSL Ubuntu 中文环境配置脚本 # 1. 安装中文 locale echo [1/4] 安装中文语言包... sudo apt update sudo apt install -y language-pack-zh-hans # 2. 生成并配置 locale echo [2/4] 配置系统 locale... sudo locale-gen zh_CN.UTF-8 # 写入环境变量避免重复写入 if ! grep -q LANGzh_CN.UTF-8 ~/.bashrc; then echo export LANGzh_CN.UTF-8 ~/.bashrc echo export LC_ALLzh_CN.UTF-8 ~/.bashrc fi # 立即生效 export LANGzh_CN.UTF-8 export LC_ALLzh_CN.UTF-8 # 3. 安装中文字体 echo [3/4] 安装中文字体... sudo apt install -y \ fonts-wqy-zenhei \ fonts-wqy-microhei \ fonts-noto-cjk \ fonts-noto-cjk-extra \ xfonts-wqy \ fontconfig # 4. 刷新字体缓存 echo [4/4] 刷新字体缓存... fc-cache -fv echo echo 配置完成 echo 当前 locale 配置 locale | grep -E LANG|LC_ALL echo echo 中文字体数量$(fc-list :langzh | wc -l) 个 echo echo 请重新打开终端或执行: source ~/.bashrc保存和运行的方式cat ~/setup_chinese_env.sh EOF # 把上面整段脚本内容粘进来 EOF chmod x ~/setup_chinese_env.sh ~/setup_chinese_env.sh现在关键来了。把这段脚本贴给 Codex 时给它一个明确的排查指令比如这是我在 WSL Ubuntu 里用来解决 cc-switch 图形界面乱码的中文环境脚本。请逐行检查1LANG 和 LC_ALL 是否真的写入了 ~/.bashrc有没有被覆盖或重复写入2中文字体包是否装全有没有遗漏3fc-cache 是否刷新成功。每检查一段告诉我该跑什么命令验证并解释命令输出代表什么。Codex 会一段一段给你分析。比如它会指出export LANG写在脚本里只对当前 shell 生效新开终端要靠 ~/.bashrc 里那两行它会让你跑grep -n LANG\|LC_ALL ~/.bashrc确认写入位置它会让你跑locale看当前会话的实际值它会让你跑fc-list :langzh | wc -l看中文字体数量是不是 0。这里每让 Codex 分析一段、每让它给一条验证命令都会消耗 Token。所以指令给清楚别来回问废话能省不少用量。TaoToken 后台的用量统计这时候就有用了你能看到这次排查大概花了多少。4. 验证请求确认 locale 和字体真的生效脚本跑完、Codex 也分析完别急着开 cc-switch先做几组验证。这几条命令就是 Codex 通常会建议你跑的我按顺序列出来你照着执行看结果。第一组查 ~/.bashrc 里到底写没写进去grep -n LANG\|LC_ALL ~/.bashrc正常应该看到类似export LANGzh_CN.UTF-8 export LC_ALLzh_CN.UTF-8如果什么都没有说明脚本里那个if ! grep -q判断出了问题或者你根本没 source。这时候手动补echo export LANGzh_CN.UTF-8 ~/.bashrc echo export LC_ALLzh_CN.UTF-8 ~/.bashrc source ~/.bashrc第二组查当前会话的 locale 实际值locale重点看这几行LANGzh_CN.UTF-8 LC_ALLzh_CN.UTF-8如果显示LANGC.UTF-8或者LANGen_US.UTF-8说明环境变量没生效多半是没 source 或者被别的配置覆盖了。注意 LC_ALL 优先级最高它一旦设成 CLANG 设什么都没用。第三组查中文字体数量fc-list :langzh | wc -l这个数字如果是 0说明字体没装上或者缓存没刷新。正常装完 fonts-wqy 和 noto-cjk 之后这个数应该是几十甚至上百。如果还是 0先确认包装没装dpkg -l | grep -E fonts-wqy|fonts-noto-cjk再手动刷一次缓存fc-cache -fv第四组直接看字体列表里有没有文泉驿fc-list | grep -i wqy有输出就说明字体系统认到了。到这里locale 和字体两条线都验证通过再重新打开 cc-switch界面中文应该就正常了。如果还乱码往下看排查部分。5. 本篇常见错排查排障视角下这几个坑我基本都踩过列出来你对照。坑一Base URL 多写了 /v1。这是接入阶段最常见的。Codex 报连接错误或者 404第一反应去查网络其实地址写错了。记住 TaoToken 填https://taotoken.net/api不带 /v1。改完重启 Codex 再试。坑二脚本跑了但没 source。脚本里export LANG只影响脚本自己的进程脚本一结束就没了。新开终端读的是 ~/.bashrc。所以要么重开终端要么source ~/.bashrc。很多人跑完脚本直接开 cc-switch发现还是乱码就是这个原因。坑三LC_ALL 被设成 C 或 POSIX。有些系统或工具会在别处设 LC_ALLC它的优先级高于 LANG。查locale输出如果 LC_ALL 不是 zh_CN.UTF-8去 ~/.bashrc 或 /etc/default/locale 里找覆盖它的地方。坑四字体装了但 fc-cache 没刷。字体包安装后需要刷新缓存系统才知道有新字体。fc-cache -fv的输出里会列出扫描的目录如果它报权限错误或者跳过某些目录字体可能没被收录。用fc-list :langzh确认。坑五WSL 的图形界面走的是 Windows 侧字体。如果你用的是 WSLg图形程序渲染可能部分依赖 Windows 字体。Ubuntu 侧字体装全了但 Windows 没装对应字体个别字符还是可能显示异常。这种情况在 Ubuntu 侧装 noto-cjk 通常能覆盖大部分。坑六Codex 分析时 Token 消耗过快。如果你把整个脚本反复贴、反复问用量会涨得很快。建议一次贴全指令写清楚让它一次性给完整排查方案而不是一问一答挤牙膏。用量在 TaoToken 控制台能看心里有数。排查顺序建议先确认 Base URL 和 Key 没问题Codex 能正常回话再确认 ~/.bashrc 写入再确认 locale 输出最后确认字体数量。一层层往下别跳。6. 后续怎么用这套组合这套流程跑通之后你其实得到的不只是「修好一次乱码」。脚本 Codex 的组合可以复用以后 WSL 里再遇到环境配置类问题比如时区、编码、依赖缺失都可以把相关脚本贴给 Codex让它逐行分析、给验证命令、判断输出。需要长期做编码和 Agent 任务的话去 https://taotoken.net/api-keys 管理你的 Key用量和额度都在控制台。想直接验证模型对话效果可以走模型对话入口接入文档在 https://taotoken.net/doc 有详细说明。Coding Plan 适合高频使用的场景按需选。回到这次的问题cc-switch 乱码本质是 locale 和字体两件事。脚本负责把这两件事做掉Codex 负责验证它们真的做掉了TaoToken 负责让 Codex 稳定跑起来。三者各司其职别指望 TaoToken 去改你的系统它只提供通道和统计。你把脚本贴对、命令跑对、结果看对乱码自然就没了。