1. 为什么 2025 年还要认真配一次 VS Code Java 环境
VS Code 写 Java 这件事，2025 年的体验和几年前完全不是一个量级。以前大家吐槽它「插件装一堆、补全慢半拍、跑个 Hello World 还要手动配 classpath」，现在 Extension Pack for Java 加上 Language Server 的迭代，日常写 Spring Boot、写算法题、写工具类脚本都够用了。但问题也很集中：新手第一次装完 JDK 和插件，打开一个.java文件，右下角一直转圈、状态栏显示 "Java: Loading..."，或者编译报The type java.lang.Object cannot be resolved，本质都是 JDK 路径没被 VS Code 正确识别。
这篇聚焦的场景很明确：2025 年从零在 VS Code 里搭一套能跑通的 Java 开发环境，覆盖 JDK 安装、扩展选择、settings.json核心配置，最后交付一份可以直接复制的配置骨架。同时我会把 TaoToken 的统一 Key 接入片段一起放进去——因为现在很多人的 Java 项目里会调用大模型能力（比如写个代码审查小工具、批量生成注释、接一个对话接口做内部助手），把 Key 统一管理起来比散落在各个.env里省心得多。
适合谁看：刚装完 VS Code 想写 Java 的同学、从 Eclipse/IDEA 转过来想轻量化的人、以及需要在 Java 工程里接入模型 API 但不想每个项目重复配 Key 的开发者。整篇按「装 JDK → 装扩展 → 写 settings.json → 验证 Hello World → 排错」的顺序走，每一步都有可复制的命令和配置。
2. 前置准备：JDK 与 TaoToken 统一 Key
2.1 JDK 选哪个版本
2025 年主流选择是 JDK 21（LTS）或 JDK 17（LTS）。JDK 21 支持虚拟线程，写并发工具类更舒服；JDK 17 生态兼容性最稳。如果你只是学习语法和刷题，两个都行，我建议直接上 21。下载渠道用 Eclipse Temurin 或 Oracle 官方都行，装完记住安装路径，Windows 一般是C:\Program Files\Eclipse Adoptium\jdk-21.x.x-hotspot，macOS 用/usr/libexec/java_home -V能列出所有已装 JDK。
装完在终端验证：
java -version javac -version两条命令输出的版本号要一致。如果java有输出但javac提示找不到，说明你装的是 JRE 不是 JDK，回去重新下。
2.2 TaoToken 统一 Key 是什么、能做什么
TaoToken 提供的是统一的大模型 API 接入层，一个 Key 可以调用多种模型，省去在多个平台分别注册、分别管额度。对 Java 开发者来说，典型用法是在项目里发一个 HTTP 请求做代码补全、注释生成、日志分析这类任务。它的 API 地址是https://taotoken.net/api，官网在https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。
你需要先拿到 Key：进控制台创建 API Key，路径是https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，Key 管理页在https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。拿到一串sk-开头的字符串后，别直接硬编码进 Java 源码，后面我会用 VS Code 的配置和系统环境变量两种方式管理它。
注意：Key 属于敏感凭证，不要提交到 Git 仓库。VS Code 的
settings.json里如果写 Key，只适合本机个人使用，团队协作请走环境变量。
3. 可复制配置：扩展安装与 settings.json 骨架
3.1 扩展怎么装
VS Code 里按Ctrl+Shift+X（macOS 是Cmd+Shift+X）打开扩展面板，搜索Extension Pack for Java，由 Microsoft 发布，安装它会自动带上 7 个附属扩展：Language Support、Debugger、Test Runner、Maven、Project Manager、IntelliCode、Visual Studio IntelliCode API Usage。这一步就是原教程里说的「会自动安装附带的 7 个插件」，不用一个个手动点。
如果你用 Spring Boot，再补一个Spring Boot Extension Pack。只写普通 Java 的话，上面那个包就够了。
3.2 settings.json 核心骨架
按Ctrl+Shift+P打开命令面板，输入Preferences: Open User Settings (JSON)，把下面这份骨架贴进去。这份配置解决三件事：告诉 VS Code JDK 在哪、统一代码风格、把 TaoToken 的接入参数集中管理。
{ "java.jdt.ls.java.home": "C:\\Program Files\\Eclipse Adoptium\\jdk-21.0.5.11-hotspot", "java.configuration.runtimes": [ { "name": "JavaSE-21", "path": "C:\\Program Files\\Eclipse Adoptium\\jdk-21.0.5.11-hotspot", "default": true } ], "java.compile.nullAnalysis.mode": "automatic", "java.format.settings.profile": "GoogleStyle", "editor.formatOnSave": true, "editor.tabSize": 4, "files.autoSave": "onFocusChange", "java.configuration.updateBuildConfiguration": "automatic", "taotoken.apiBase": "https://taotoken.net/api", "taotoken.defaultModel": "claude-sonnet-4-5", "taotoken.apiKeyEnv": "TAOTOKEN_API_KEY" }几个关键点解释一下。java.jdt.ls.java.home是给 Language Server 用的 JDK 路径，这个必须对，否则补全和跳转全废。java.configuration.runtimes是给项目编译运行用的运行时列表，default: true表示默认用这个。路径里的反斜杠要写成双反斜杠，这是 JSON 转义要求，Windows 用户最容易在这里翻车。
macOS 或 Linux 用户把路径换成/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home这种形式即可，用正斜杠不用转义。
taotoken.apiKeyEnv这一项不是 VS Code 内置的，是我约定用环境变量名来引用 Key，避免把明文写进配置文件。真正读取 Key 的逻辑放在 Java 代码里，通过System.getenv("TAOTOKEN_API_KEY")拿。
3.3 环境变量设置
Windows 用 PowerShell 临时设置（当前会话有效）：
$env:TAOTOKEN_API_KEY="sk-你的Key"想永久生效就进「系统属性 → 环境变量」新建一条用户变量。macOS/Linux 写进~/.zshrc或~/.bashrc：
export TAOTOKEN_API_KEY="sk-你的Key"改完重启 VS Code，让它继承新的环境变量。
4. 验证请求：编译运行 Hello World 并调用一次模型接口
4.1 先跑通 Hello World
新建一个文件夹当项目根目录，在里面建Demo.java。注意文件名和类名必须一致，这是 Java 的硬性规定，原教程也强调了这点：
public class Demo { public static void main(String[] args) { System.out.println("Hello World"); } }在 VS Code 里打开这个文件，右上角会出现一个三角运行按钮，点它。终端应该输出Hello World。如果没出现运行按钮，说明 Java 扩展没激活或者 JDK 路径不对，回到第 3 节检查java.jdt.ls.java.home。
也可以用命令行验证，在项目目录下执行：
javac Demo.java java Demo先编译出Demo.class，再运行。两条都成功，说明 JDK 和 PATH 都没问题。
4.2 用 Java 调一次 TaoToken 接口
下面这段代码用 JDK 自带的HttpClient（JDK 11+ 可用）发一个请求，验证 Key 能通。不需要引入任何第三方依赖，复制就能跑：
import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class TaoTokenDemo { public static void main(String[] args) throws Exception { String apiKey = System.getenv("TAOTOKEN_API_KEY"); if (apiKey == null || apiKey.isEmpty()) { System.out.println("未找到 TAOTOKEN_API_KEY 环境变量"); return; } String body = """ { "model": "claude-sonnet-4-5", "messages": [ {"role": "user", "content": "用一句话说明 Java 的 main 方法作用"} ] } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://taotoken.net/api/v1/chat/completions")) .header("Content-Type", "application/json") .header("Authorization", "Bearer " + apiKey) .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); HttpClient client = HttpClient.newHttpClient(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println("状态码: " + response.statusCode()); System.out.println("响应: " + response.body()); } }运行后如果看到状态码: 200和一段 JSON 响应，说明 Key 和环境变量都配对了。如果返回 401，是 Key 无效或没读到；返回 404，检查 URL 路径是否写全。
提示：模型名可以按需替换，具体可用模型列表在模型对话页
https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=查看。如果你要长期在编码场景里用，可以了解 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。
5. 本篇常见错误排查
5.1 状态栏一直显示 Java: Loading
最常见原因是java.jdt.ls.java.home指向了 JRE 或者路径写错。打开命令面板执行Java: Clean Java Language Server Workspace，然后重启 VS Code。还不行就在输出面板选Language Support for Java看具体报错。
5.2 报 The type java.lang.Object cannot be resolved
这是 classpath 没配好，通常是java.configuration.runtimes里的 path 不对，或者项目根目录没有正确的构建文件。纯 Java 单文件项目，确保文件在项目根目录下，不要放在奇怪的嵌套层级里。
5.3 运行按钮不出现
检查文件是否已保存、扩展是否启用、右下角语言模式是否是 Java。有时候文件被识别成纯文本，点右下角手动切成 Java 就好了。
5.4 环境变量读不到
VS Code 是从启动它的父进程继承环境变量的。如果你在设置环境变量之前就打开了 VS Code，需要完全退出再重开，不是关窗口，是退出进程。Windows 上可以在任务管理器里确认 Code.exe 全部结束。
5.5 中文乱码
Windows 终端默认编码可能是 GBK，Java 输出中文会乱码。在settings.json里加一行"terminal.integrated.defaultProfile.windows": "PowerShell"，或者编译时加-encoding UTF-8参数。
6. 把 Key 和配置沉淀成可复用骨架
走到这里，你的 VS Code 应该已经能编译、运行、调试 Java，并且能通过统一 Key 调通模型接口了。最后说几个让这套配置更耐用的做法。
第一，把settings.json里跟机器相关的路径抽出来。如果你在多台机器上开发，路径不一样，可以改用 VS Code 的 profile 功能，或者干脆把这份骨架存成 gist，换机器时改两行路径就行。
第二，Key 永远走环境变量，不要图省事写进settings.json的明文字段。团队里如果有人误提交，后果比想象中麻烦。
第三，Java 项目一旦引入 Maven 或 Gradle，java.configuration.updateBuildConfiguration设成automatic能省很多手动刷新。构建文件改动后 VS Code 会自动重新加载 classpath。
第四，如果你要在 Java 工程里做更复杂的模型调用（流式输出、多轮对话、工具调用），建议单独封装一个 client 类，把 base URL 和 Key 读取逻辑收在一处，业务代码只调方法。这样以后换模型或换接入方式，改动面最小。
需要查接入细节的话，接入文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，Key 管理在https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。配置这东西，一次配好，后面写代码就顺了。
