1. Mac 上 Cursor 配置 JDK 与 Maven 版本踩坑实录
在 Mac 上用 Cursor 写 Java 项目，最容易翻车的不是代码本身，而是环境版本对不上。你可能遇到过这种情况：终端里java -version显示的是 JDK 17，但 Cursor 里打开项目却报The declared package does not match，或者 Maven 构建时提示Source option 8 is no longer supported。这类问题的根源，通常是 Cursor 的 Java 语言服务器（redhat.java）读取的 JDK 路径、Maven 的settings.xml路径，以及系统 shell 里的JAVA_HOME三者不一致。
Cursor 本质上是基于 VS Code 分支的编辑器，它的 Java 能力来自 Eclipse JDT Language Server 插件。这个插件不会自动继承你终端里export JAVA_HOME=...的设置，而是通过settings.json里的java.jdt.ls.java.home和java.configuration.runtimes来定位 JDK。Maven 同理，它默认找~/.m2/settings.xml，但如果你用 SDKMAN 或手动解压的 Maven，配置文件可能在别处。所以「Mac 上 Cursor 配置 JDK 与 Maven 版本」这件事，核心就是让编辑器、终端、构建工具三方指向同一套路径。
这篇内容适合三类人：刚在 Mac 上装完 Cursor 想跑 Spring Boot 的 Java 新手；手里有多个 JDK 版本、需要在 8/11/17 之间切换的老手；以及想把 AI 补全能力接进 Cursor、又不想在多个平台反复填 Key 的开发者。我会先讲清楚 Cursor 的 Java 配置怎么写，再给出 SDKMAN 管理多版本 JDK 的完整命令，最后把 TaoToken 的统一 Key 接入 Cursor 的步骤补上，让 AI 对话和代码补全走同一条通道。
需要提前说明的是，Cursor 的 AI 功能和 Java 语言服务是两套独立机制。Java 配置解决的是编译、跳转、补全的准确性问题；TaoToken 接入解决的是 AI 模型调用的问题。两者互不干扰，但都通过settings.json管理，所以放在一起讲更顺。
2. TaoToken 统一 Key 接入前的准备与路径确认
在把 TaoToken 接进 Cursor 之前，先确认两件事：你的 Mac 上 JDK 装在哪、Maven 装在哪。因为后面写settings.json时要用绝对路径，路径写错会导致语言服务器启动失败，报Cannot find Java runtime之类的错误。
先看 JDK。Mac 上常见的 JDK 安装位置有三种：Oracle JDK 在/Library/Java/JavaVirtualMachines/下，每个版本一个.jdk目录；Homebrew 装的 OpenJDK 在/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home（Apple Silicon）或/usr/local/opt/...（Intel）；SDKMAN 装的在~/.sdkman/candidates/java/下。你可以用这条命令列出所有已安装的 JDK：
/usr/libexec/java_home -V输出会列出每个 JDK 的版本和路径，比如17.0.9 (arm64) "Homebrew" - "OpenJDK 17.0.9" /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home。把你要用的那个路径记下来。
再看 Maven。如果你用 Homebrew 装，mvn -v会显示 Maven home 路径，通常在/opt/homebrew/Cellar/maven/3.9.x/libexec。如果用 SDKMAN 装，路径在~/.sdkman/candidates/maven/current。Maven 的settings.xml一般在conf/子目录下，或者用户级的~/.m2/settings.xml。Cursor 的java.configuration.maven.userSettings要填的是settings.xml的完整路径，不是 Maven 安装目录。
TaoToken 这边，你需要先拿到一个 API Key。访问https://taotoken.net/api-keys创建 Key，然后确认 Base URL 是https://taotoken.net/api。这个 Base URL 在 Cursor 里配置自定义模型时会用到。TaoToken 的模型对话入口在https://taotoken.net/chat，Coding Plan 在https://taotoken.net/coding-plan，接入文档在https://taotoken.net/doc。这些地址后面配置时按需引用。
有一点要注意：Cursor 的 AI 配置和 Java 配置虽然都在settings.json，但 AI 相关的 Key 通常存在 Cursor 自己的账户体系或环境变量里，不是直接写进settings.json的明文。具体做法在下一节展开。
3. 可复制配置：settings.json 与 SDKMAN 版本切换
这一节给两份可直接复制的配置。第一份是 Cursor 的settings.json，解决 JDK 和 Maven 路径问题；第二份是 SDKMAN 的命令序列，解决多版本切换问题。
先打开 Cursor，按Cmd + Shift + P，输入Open User Settings (JSON)，选中后会在编辑器里打开settings.json。把下面这段追加进去，注意把路径替换成你自己的：
{ "window.commandCenter": true, "redhat.telemetry.enabled": false, "editor.fontSize": 14, "editor.renderWhitespace": "all", "java.jdt.ls.java.home": "/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home", "java.configuration.runtimes": [ { "name": "JavaSE-1.8", "path": "/Library/Java/JavaVirtualMachines/jdk1.8.0_171.jdk/Contents/Home" }, { "name": "JavaSE-17", "path": "/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home", "default": true } ], "java.configuration.maven.userSettings": "/Users/yourname/.m2/settings.xml", "java.configuration.updateBuildConfiguration": "automatic", "java.compile.nullAnalysis.mode": "automatic", "java.dependency.packagePresentation": "hierarchical", "editor.formatOnSave": true, "editor.detectIndentation": false, "editor.tabSize": 4, "[java]": { "editor.suggest.snippetsPreventQuickSuggestions": false, "editor.suggestSelection": "first", "editor.defaultFormatter": "redhat.java" }, "java.completion.importOrder": ["java", "javax", "org", "com"] }这里java.jdt.ls.java.home是语言服务器自己运行的 JDK，建议用 17 或更高，因为新版 JDT LS 对 8 的支持在弱化。java.configuration.runtimes是项目可选的运行时，default: true的那个会成为新项目的默认。java.configuration.maven.userSettings指向你的settings.xml，如果文件不存在，先创建~/.m2/settings.xml，内容可以是空的<settings></settings>。
保存后，Cursor 右下角会提示 Java 语言服务器重启。如果路径写错，会弹Java runtime not found，这时检查路径里有没有多余空格或拼写错误。
接下来是 SDKMAN 管理 JDK 版本。如果你还没装 SDKMAN，先执行：
curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"然后安装 Zulu 的 JDK 8 和 17：
sdk install java 8.0.302-zulu sdk install java 17.0.9-zulu切换版本用：
sdk use java 8.0.302-zulu java -versionuse只在当前终端生效，default会永久切换：
sdk default java 17.0.9-zuluSDKMAN 装的 JDK 路径在~/.sdkman/candidates/java/8.0.302-zulu，你可以把这个路径填进java.configuration.runtimes。这样终端和 Cursor 就能指向同一个 JDK。
Maven 也可以用 SDKMAN 装：
sdk install maven 3.9.6 sdk use maven 3.9.6 mvn -v装完后settings.xml在~/.sdkman/candidates/maven/current/conf/settings.xml，把它复制到~/.m2/下再改，避免升级 Maven 时配置丢失。
4. 验证请求：确认 JDK、Maven 与 AI 通道都生效
配置写完不代表生效，得逐项验证。先验证 JDK。在 Cursor 里新建一个Test.java，输入：
public class Test { public static void main(String[] args) { System.out.println(System.getProperty("java.version")); System.out.println(System.getProperty("java.home")); } }右键选择Run Java，终端会输出当前使用的 JDK 版本和路径。如果输出的路径和你settings.json里default: true的那个一致，说明运行时配置生效。如果不一致，检查项目根目录有没有.vscode/settings.json覆盖了用户配置。
再验证 Maven。在项目根目录执行：
mvn -v mvn help:effective-settings第一条显示 Maven 版本和 Java 版本，第二条显示实际生效的settings.xml内容。如果effective-settings里的本地仓库路径、镜像配置和你预期一致，说明 Maven 配置正确。如果 Cursor 里 Maven 依赖报红，按Cmd + Shift + P执行Java: Clean Java Language Server Workspace，然后重启。
最后验证 TaoToken 的 AI 通道。Cursor 里按Cmd + Shift + P，输入Cursor Settings，找到Models或OpenAI API Key相关项。如果你用的是 Cursor 的自定义模型功能，填入 Base URLhttps://taotoken.net/api和你在https://taotoken.net/api-keys创建的 Key，模型 ID 填你需要的（比如gpt-4o或claude-3-5-sonnet）。保存后在 Chat 面板发一条ping，能收到回复就说明通道通了。
如果你用的是 Claude Code 类的接入方式，配置三件套是：Base URL 填https://taotoken.net/api，Key 填sk-开头的字符串，Model ID 填具体模型名。这三项缺一不可，少填 Model ID 会报model not found。
验证通过后，你可以在 Cursor 里同时享受准确的 Java 补全和 AI 对话，两者互不抢占资源。
5. 本篇常见错排查：401、local proxy failed 与 reading choices
配置过程中最容易撞上的报错有四个，逐个说清楚。
第一个是401 Unauthorized。这通常出现在 AI 通道验证时，原因是 Key 填错、Key 过期，或者 Base URL 末尾多了斜杠。检查https://taotoken.net/api-keys里的 Key 是否复制完整，Base URL 是否严格写成https://taotoken.net/api，不要写成https://taotoken.net/api/或https://taotoken.net/v1。如果 Key 没问题，去https://taotoken.net/console看下额度是否用完。
第二个是local proxy failed或connect ECONNREFUSED。这多半是 Cursor 的网络代理设置和系统代理冲突。打开 Cursor 设置，搜索proxy，把Http: Proxy清空，或者设为null。如果你在用公司网络，确认没有强制走代理。这个报错和 TaoToken 本身无关，是本地网络层的问题。
第三个是Cannot read property 'choices' of undefined。这个报错说明请求发出去了，但返回体结构不对。常见原因是 Model ID 填错，比如填了gpt-4但通道只支持gpt-4o，或者填了带前缀的openai/gpt-4o。去https://taotoken.net/doc查一下当前支持的模型 ID 列表，填准确的名称。另一个可能是 Base URL 少了/api，导致请求打到了网页端而不是 API 端。
第四个是OAuth token expired或authentication failed。如果你用的是 Cursor 内置的 Claude 或 GPT 登录态，而不是自定义 Key，可能会遇到 OAuth 过期。解决办法是退出 Cursor 账户重新登录，或者干脆切到自定义 Key 模式，用 TaoToken 的 Key 替代 OAuth。自定义 Key 模式在Cursor Settings的Models里开启，填入 Base URL 和 Key 即可。
还有一个 Java 侧的常见错：The project was not built since its build path is incomplete。这是 Maven 依赖没下载完或settings.xml路径不对。执行mvn clean install -U强制更新，然后在 Cursor 里执行Java: Reload Projects。
排查时记住一个原则：Java 报错看settings.json路径，AI 报错看 Base URL 和 Key。两者分开定位，不要混在一起改。
6. 长期编码与 Agent 场景的接入建议
如果你只是偶尔用 Cursor 写写 Java，上面的配置够用了。但如果你打算长期用 Cursor 做 Java 后端开发，或者跑 Agent 类的自动化任务，有几个点值得提前规划。
第一，把 JDK 和 Maven 的版本管理统一到 SDKMAN。不要混用 Homebrew 和手动解压的 JDK，否则java.configuration.runtimes里的路径会越来越乱。SDKMAN 的sdk use和sdk default能让你在终端和 Cursor 之间保持一致的版本语义。每次切换 JDK 后，记得在 Cursor 里执行Java: Clean Java Language Server Workspace，让语言服务器重新读取运行时。
第二，Maven 的settings.xml建议放在~/.m2/下，而不是 Maven 安装目录的conf/下。这样升级 Maven 时配置不会丢，Cursor 的java.configuration.maven.userSettings也只需要指向一个固定路径。如果你用私有仓库或镜像，在settings.xml的<mirrors>里配好，Cursor 和终端会共用同一份配置。
第三，AI 通道方面，如果你需要长期跑编码任务或 Agent 工作流，可以了解下https://taotoken.net/coding-plan的额度方案。它和按量计费的 API Key 是两套体系，适合高频调用场景。日常调试用 API Key 就够了，接入文档在https://taotoken.net/doc，里面有各语言 SDK 的示例。
第四，Cursor 的 Java 插件和 AI 插件会争抢内存。如果你的项目比较大，在settings.json里给 Java 语言服务器加内存参数：
"java.jdt.ls.vmargs": "-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx4G -Xms512m"-Xmx4G根据你 Mac 的内存调整，16G 内存的机器给 4G 比较稳。
最后，验证模型是否可用可以直接在https://taotoken.net/chat里试，不用每次都开 Cursor。这样排查问题时能快速区分是通道问题还是编辑器配置问题。整套流程跑通后，你在 Mac 上的 Java 开发环境就同时具备了版本可控和 AI 辅助两个能力，后续换项目或换 JDK 版本时，只需要改settings.json里的路径和 SDKMAN 的use命令，不用重装任何东西。
