排错中心
配置未生效排查
配置未生效通常不是“保存失败”这么简单，更常见的是改错来源、被更高优先级配置覆盖，或旧进程没有重新读取。
提示：先确认当前使用的客户端、配置来源和权限范围，再按本文步骤操作。配置未生效排查完成后仍要用最小任务验证。
01.
先确定问题现象
定位配置来源、覆盖优先级、旧进程和缓存。
配置未生效通常不是“保存失败”这么简单，更常见的是改错来源、被更高优先级配置覆盖，或旧进程没有重新读取。
确认改的是哪一份配置
记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
检查覆盖优先级
查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
完全重启客户端
关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
这一节的目标：先确认要解决的问题、当前客户端和配置来源，再开始修改。
02.
复现前保留证据
开始前把环境、材料和权限边界列清楚，可以避免把安装问题、配置问题和服务端问题混在一起。
- 保留错误原文、时间与执行动作
- 记录客户端、配置来源和当前目录
- 先用最小请求复现，暂时移除复杂变量
03.
四步定位故障层
- 1
确认改的是哪一份配置
记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
- 2
检查覆盖优先级
查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
- 3
完全重启客户端
关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
- 4
用可识别差异验证
选择一个能明确区分的新模型或测试配置，发送最小请求并记录结果。
04.
怎样确认问题已解决
不要把“已经保存”或“没有弹窗”当成成功。至少确认下面三项都有可观察结果。
- 配置路径和优先级已明确
- 旧进程已经退出
- 新请求能识别当前目标配置
验证原则：先做只读、最小、可重复的检查，再把同一配置用于真实任务。
05.
常见误判与边界
为什么文件内容已经变了，客户端仍用旧配置？
客户端可能读取另一文件、环境变量或启动时缓存，需要核对实际来源并重启。
删除所有配置再重做可以吗？
不建议先删除。保留备份并逐层排除，更容易找到真正覆盖来源。
06.
恢复真实任务前的检查
把当前方法压缩成四个动作，完成后再进入相邻教程，不必一次改动所有配置。
- 1确认改的是哪一份配置记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
- 2检查覆盖优先级查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
- 3完全重启客户端关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
- 4用可识别差异验证选择一个能明确区分的新模型或测试配置，发送最小请求并记录结果。