1. 更新完环境变量，为什么 VSCode/cursor 还在读旧 JDK
你大概率遇到过这个场景：电脑上装了 JDK 8、JDK 17、JDK 21 好几个版本，系统环境变量里JAVA_HOME和PATH都改成了新版本，命令行java -version也显示对了，结果一打开 VSCode 或者 cursor，终端里敲java -version还是老版本，Java 插件报的编译级别、Gradle 用的 JDK 也全是旧的。这个「Java 环境变量更新后 VSCode/cursor 仍读取旧值」的问题，本质不是环境变量没改对，而是进程继承 + 编辑器自身配置覆盖两层机制在打架。
先说清楚它是什么、能帮到谁。VSCode 和 cursor 都是基于 Electron 的编辑器，它们启动时会从父进程（Windows 的资源管理器、macOS 的 Dock/Finder）继承一份环境变量快照。你在改完系统环境变量之后，如果编辑器进程没有完全退出重启，它内存里那份快照就还是旧的。更麻烦的是，Java 插件（Red Hat 的 Language Support for Java）和终端集成（terminal.integrated.env.*）各自还有一套覆盖逻辑，优先级比系统环境变量高。所以你会看到「系统里是新的、编辑器里是旧的」这种割裂现象。
适合谁看：装了多版本 JDK 的 Java 开发者、用 cursor 写 Spring Boot 的同学、以及把 AI 编程插件 endpoint 指向统一 Key 通道（比如 TaoToken）后想排除环境干扰的人。我试过在一台同时有 JDK 8 和 JDK 21 的 Windows 机器上反复折腾，最后发现光改系统变量根本不够，必须把编辑器配置、终端配置、插件配置三层一起对齐，再用java -version和插件日志双重确认，才算真正生效。
下面这份排查清单，就是按「先定位、再覆盖、后验证」的顺序整理的，每一步都能直接复制操作。
2. 前置准备：把 TaoToken 的 Key 通道和 Base URL 先理清楚
在动 Java 环境变量之前，建议先把 AI 插件的接入通道统一好，否则你排查 Java 问题时，插件日志里混着网络报错，根本分不清是 JDK 的问题还是 endpoint 的问题。TaoToken 在这里扮演的角色是「统一 Key 通道」：你只需要一个 API Key，就能在多个 AI 编程插件里复用，Base URL 统一指向https://taotoken.net/api，不用每个插件单独配一套凭证。
具体要准备三样东西，我把它叫做「三件套」：Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api，注意这里不带任何多余路径；API Key 去控制台生成，地址是https://taotoken.net/console/api-keys；Model ID 按你实际用的模型填，比如 Claude 系列或 GPT 系列的具体标识。这三件套在 Cline、Continue、Codex 这类插件里是通用的，配一次就能到处用。
如果你用的是 Claude Code 这类命令行工具，接入方式略有不同，需要参考官方文档里的 Anthropic 兼容配置，文档入口在https://taotoken.net/doc。想先验证模型通不通，可以直接用模型对话页面测一下，地址是https://taotoken.net/models，发一条消息看有没有正常返回，确认 Key 和 Base URL 没问题，再去配插件。
为什么要先做这一步？因为后面排查 Java 环境变量时，你会频繁看插件日志。如果插件本身因为 endpoint 配错在报 401 或者连接失败，日志里全是网络错误，你就没法判断 Java 那部分到底生效没有。先把 AI 通道理顺，日志干净了，Java 的问题才看得清。长期做编码和 Agent 任务的话，可以考虑 Coding Plan，地址是https://taotoken.net/coding-plan，适合高频调用场景。
这一步的核心原则：先隔离变量。Java 环境是一组变量，AI 插件通道是另一组变量，两组分开验证，出问题时才能快速定位是哪一组。
3. 可复制配置：settings.json 覆盖 + 三件套对齐
这一节是整篇的核心，直接给你能复制的配置。先说 VSCode/cursor 的settings.json，这是解决「编辑器读旧 JDK」最关键的一层。打开设置（快捷键Ctrl+,或Cmd+,），搜索Java: Home，或者直接编辑settings.json文件。Windows 下的路径通常在%APPDATA%\Code\User\settings.json，cursor 则是%APPDATA%\Cursor\User\settings.json；macOS 下在~/Library/Application Support/Code/User/settings.json。
把下面这段贴进去，注意把 JDK 路径换成你自己的实际路径：
{ "terminal.integrated.env.windows": { "PATH": "C:\\Program Files\\Java\\jdk-21\\bin;${env:PATH}", "JAVA_HOME": "C:\\Program Files\\Java\\jdk-21" }, "terminal.integrated.env.osx": { "PATH": "/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home/bin:${env:PATH}", "JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home" }, "terminal.integrated.defaultProfile.windows": "JavaSE-21", "java.import.gradle.java.home": "C:\\Program Files\\Java\\jdk-21", "java.jdt.ls.java.home": "C:\\Program Files\\Java\\jdk-21" }这里有几个坑要提醒。第一，terminal.integrated.env.windows里的PATH一定要把新 JDK 的bin放在${env:PATH}前面，否则系统 PATH 里的旧 JDK 会先被命中。第二，java.jdt.ls.java.home这个键很多人不知道，它控制的是 Java 语言服务器自己用哪个 JDK 启动，不配的话插件可能还在用旧版本跑语言服务。第三，java.import.gradle.java.home是给 Gradle 项目用的，Spring Boot 项目尤其要注意。
macOS 用户注意，路径里是Contents/Home，别漏了。另外 macOS 上如果你用jenv或者 SDKMAN 管理版本，JAVA_HOME可能被 shell 配置文件（.zshrc）覆盖，这时候编辑器继承的还是登录 shell 的环境，需要在settings.json里显式写死。
接下来是 AI 插件的三件套配置。以 Cline 为例，在插件设置里填：
{ "apiProvider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "你的_TaoToken_API_Key", "modelId": "你的模型ID" }如果你用 Codex，配置写在~/.codex/auth.json里，结构类似，Base URL 同样是https://taotoken.net/api。Cline 的 MCP 配置也走同一套 Key，MCP server 的 endpoint 指向统一通道即可。这里的关键是：Base URL 和 Key 只配一处，其他插件复用，这样排查时你只需要确认一个通道是否正常。
把 Java 配置和 AI 插件配置放在同一份settings.json里管理，好处是版本可控、迁移方便。你可以把这份文件纳入 dotfiles 仓库，换机器时直接拉下来。
4. 验证请求：终端重启、进程继承与双重确认
配置写完不代表生效，必须验证。这一步分三个层次：终端层、进程层、插件层。
第一层，终端验证。完全退出VSCode/cursor，不是关窗口，是彻底退出进程。Windows 下在任务管理器里确认Code.exe或Cursor.exe全部结束；macOS 下Cmd+Q退出，或者用ps aux | grep -i cursor确认没有残留。然后重新打开编辑器，新建一个集成终端，敲：
java -version echo $JAVA_HOMEWindows PowerShell 下用echo $env:JAVA_HOME。如果显示的是新版本，说明终端层的terminal.integrated.env.*生效了。如果还是旧的，检查settings.json有没有语法错误，JSON 里多个键之间别忘了逗号。
第二层，进程继承验证。这一步很多人忽略。编辑器是从父进程继承环境的，Windows 下如果你是从旧的文件资源管理器窗口启动的编辑器，可能继承的是旧快照。最稳妥的做法是：改完系统环境变量后，注销一次或者重启，再从全新的桌面会话启动编辑器。macOS 下如果从终端用code .启动，那继承的是当前 shell 的环境，反而更可控。你可以用这个命令确认编辑器进程实际拿到的环境：
# macOS/Linux ps eww -p $(pgrep -f "Cursor" | head -1) | tr ' ' '\n' | grep JAVA_HOMEWindows 下可以用 Process Explorer 查看进程的环境变量块。确认JAVA_HOME指向新路径，才算进程层通过。
第三层，插件日志验证。打开 Java 插件的输出面板（View -> Output，下拉选Language Support for Java），看启动日志里打印的 JDK 路径。正常应该显示你配置的新路径。同时看 AI 插件的日志，确认请求 Base URL 是https://taotoken.net/api，没有 401 或连接错误。如果 Java 日志显示新 JDK、AI 日志显示请求成功，双重确认就完成了。
实测下来，最容易翻车的是第二层。很多人改完配置直接重启编辑器窗口，但父进程还是旧的，结果怎么都不生效。记住：环境变量的继承链是「系统 -> 父进程 -> 编辑器 -> 终端/插件」，任何一环没刷新，后面全是旧的。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
排查过程中你会遇到几类典型报错，这里逐个对照。
401 Unauthorized：AI 插件日志里出现这个，基本是 API Key 或 Base URL 配错了。先确认 Base URL 是https://taotoken.net/api，注意不要多加/v1之类的路径（除非文档明确要求）。然后去https://taotoken.net/console/api-keys重新生成一个 Key，粘贴时注意别带空格。如果 Key 是对的还报 401，检查是不是把 Key 填到了错误的字段，比如填成了 organization ID。
local proxy failed / connection refused：这个通常出现在你本地配了代理，但代理没启动，或者插件走了系统代理。检查settings.json里有没有http.proxy配置，有的话先注释掉。另外确认没有把 Base URL 写成localhost或127.0.0.1开头的地址。如果用了 Cline 的 MCP，MCP server 起不来也会报类似错误，检查 MCP 配置里的 command 路径是否正确。
Error reading choices / unexpected response format：这个报错说明请求发出去了，但返回的 JSON 结构不符合插件预期。常见原因是 Model ID 填错了，或者 Base URL 指向了一个不兼容 OpenAI 格式的 endpoint。确认 Model ID 和 TaoToken 文档里列的一致，Base URL 用标准通道。如果用的是 Claude Code 的 Anthropic 兼容模式，注意请求头和路径可能和 OpenAI 格式不同，参考https://taotoken.net/doc里的说明。
OAuth 相关报错：如果你用的是需要 OAuth 登录的工具（比如某些 Codex 场景），报 OAuth 失败通常是回调地址或 token 过期。Codex 的auth.json里如果 token 过期，重新走一次授权流程。注意auth.json的路径和权限，macOS 下确保文件权限是600。
Java 侧报错：如果插件日志报Cannot find JDK或Unsupported class file major version，说明语言服务器用的 JDK 版本和项目不匹配。检查java.jdt.ls.java.home是否指向了正确的 JDK，以及项目的pom.xml或build.gradle里声明的 Java 版本。Gradle 项目还要看java.import.gradle.java.home。
排查原则：先看日志定位是哪一层，再针对性改配置。401 和 proxy 是网络层，reading choices 是协议层，OAuth 是认证层，Java 报错是工具链层。分层排查，别一上来就乱改。
6. 把通道固定下来：长期编码场景的稳定接入
Java 环境变量和 AI 插件通道都理顺之后，最后一步是把它固定成可复用的工作流，避免下次换机器或者升级 JDK 时又踩一遍。
我的做法是把settings.json拆成两部分：一部分是 Java 工具链配置，跟着项目走；一部分是 AI 插件三件套，跟着账号走。Java 部分用.vscode/settings.json放在项目根目录，这样每个项目可以锁定自己的 JDK 版本，不会互相干扰。AI 插件部分放在用户级settings.json，全局复用一套 Key。
对于长期做编码和 Agent 任务的场景，建议把 Base URL 和 Key 的管理集中化。TaoToken 的统一 Key 通道好处就在这里：你不需要为每个插件单独申请凭证，一个 Key 覆盖 Cline、Continue、Codex 等多个工具。想验证模型可用性，随时去https://taotoken.net/models发一条测试消息；需要管理多个 Key 做权限隔离，去https://taotoken.net/console/api-keys操作。高频调用的话，Coding Plan 在https://taotoken.net/coding-plan有更合适的额度方案。
最后给一个实用技巧：写一个check-env.sh或check-env.ps1脚本，每次换环境后跑一遍，自动打印java -version、JAVA_HOME、以及 AI 插件的连通性测试结果。这样你不用手动一层层查，一条命令就能确认整条链路是否正常。脚本里可以用curl打一下https://taotoken.net/api的模型列表接口，返回 200 就说明通道没问题。
环境变量这东西，改对了不难，难的是让所有下游进程都刷新到新值。记住继承链、分层验证、双重确认，这套清单能帮你省下大量反复重启的时间。
