1. 為什么要在 VS Code 里折騰 Maven Spring Boot 這套組合VS Code 這幾年在 Java 生態(tài)里的存在感越來(lái)越強(qiáng)。以前大家一提 Java 開(kāi)發(fā)就是 IntelliJ IDEA但 IDEA 社區(qū)版對(duì) Spring Boot 的支持有限旗艦版又要付費(fèi)很多學(xué)生黨和個(gè)人開(kāi)發(fā)者就開(kāi)始把目光轉(zhuǎn)向 VS Code。VS Code 本身輕量配上幾個(gè)關(guān)鍵插件之后寫(xiě) Spring Boot 的體驗(yàn)其實(shí)已經(jīng)相當(dāng)能打了。但問(wèn)題也隨之而來(lái)MAC 和 Windows 兩個(gè)平臺(tái)的環(huán)境配置路徑完全不一樣JDK 裝在哪、Maven 的 settings.xml 放哪、環(huán)境變量怎么設(shè)每一步都可能卡住新手。更麻煩的是現(xiàn)在寫(xiě)代碼離不開(kāi) AI 輔助而各家 AI 編碼工具的 Key 管理又是一團(tuán)亂麻——Claude 一個(gè) Key、GPT 一個(gè) Key、國(guó)產(chǎn)模型又一個(gè) Key切換起來(lái)非常痛苦。這篇內(nèi)容就是來(lái)解決這兩個(gè)問(wèn)題的一是把 MAC 和 Windows 雙平臺(tái)的 Maven Spring Boot 環(huán)境在 VS Code 里配通二是用 TaoToken 的統(tǒng)一 Key 通道把 AI 輔助編碼接進(jìn)來(lái)讓你在 VS Code 里寫(xiě) Spring Boot 的時(shí)候能直接調(diào)用 AI 補(bǔ)全和對(duì)話(huà)不用在多個(gè)平臺(tái)之間反復(fù)橫跳。適合誰(shuí)看剛接觸 Spring Boot 的 Java 新手、想從 IDEA 遷移到 VS Code 的開(kāi)發(fā)者、以及手頭有多個(gè) AI Key 想統(tǒng)一管理的朋友。整篇內(nèi)容按步驟走配置片段可以直接復(fù)制遇到報(bào)錯(cuò)也有排查章節(jié)。先說(shuō)清楚整體思路。VS Code 本身只是一個(gè)編輯器它不自帶 Java 運(yùn)行時(shí)也不自帶 Maven。所以我們要做的是裝 JDK、裝 Maven、裝 VS Code 的 Java 擴(kuò)展包、然后用 Maven 創(chuàng)建一個(gè) Spring Boot 項(xiàng)目、最后把 AI 輔助通道接進(jìn)來(lái)。MAC 和 Windows 的差異主要集中在 JDK 和 Maven 的安裝路徑、環(huán)境變量的設(shè)置方式上后面的 VS Code 配置和項(xiàng)目創(chuàng)建基本一致。我試過(guò)在 MAC 和 Windows 上各配一遍踩過(guò)的坑主要是環(huán)境變量沒(méi)生效、Maven 找不到 JDK、以及 VS Code 的 Java 插件版本和 JDK 版本不匹配。下面按平臺(tái)分開(kāi)講你對(duì)照自己的系統(tǒng)操作就行。2. MAC 與 Windows 雙平臺(tái) JDK 和 Maven 環(huán)境搭建實(shí)操這一節(jié)是整篇的地基。JDK 和 Maven 沒(méi)配好后面 VS Code 里怎么點(diǎn)都是紅的。2.1 MAC 平臺(tái)安裝 JDK 與 MavenMAC 上裝 JDK 最省事的方式是用 Homebrew。如果你還沒(méi)裝 Homebrew先去官網(wǎng)按提示裝一下。裝好之后打開(kāi)終端brew install openjdk17這里選 JDK 17 是因?yàn)?Spring Boot 3.x 要求最低 JDK 17。裝完之后 Homebrew 會(huì)提示你需要把 JDK 加到 PATH 里。對(duì)于 Apple Silicon 芯片的 MAC路徑通常是/opt/homebrew/opt/openjdk17Intel 芯片則是/usr/local/opt/openjdk17。編輯你的 shell 配置文件。如果你用的是 zshMAC 默認(rèn)編輯~/.zshrcecho export JAVA_HOME/opt/homebrew/opt/openjdk17 ~/.zshrc echo export PATH$JAVA_HOME/bin:$PATH ~/.zshrc source ~/.zshrc驗(yàn)證一下java -version看到openjdk version 17.x.x就說(shuō)明 JDK 裝好了。接著裝 Mavenbrew install mavenMaven 裝完后同樣驗(yàn)證mvn -v正常輸出會(huì)顯示 Maven 版本和它使用的 Java 版本。如果這里顯示的 Java 版本不對(duì)說(shuō)明JAVA_HOME沒(méi)生效回去檢查~/.zshrc。2.2 Windows 平臺(tái)安裝 JDK 與 MavenWindows 上我建議直接去 AdoptiumEclipse Temurin下載 JDK 17 的安裝包選.msi格式雙擊安裝。安裝路徑默認(rèn)是C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot。裝完之后要設(shè)環(huán)境變量。右鍵「此電腦」→「屬性」→「高級(jí)系統(tǒng)設(shè)置」→「環(huán)境變量」。在「系統(tǒng)變量」里新建變量名JAVA_HOME 變量值C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot然后編輯Path變量新增一條%JAVA_HOME%\binMaven 去官網(wǎng)下載 binary zip 包解壓到一個(gè)不帶空格的路徑比如C:\dev\apache-maven-3.9.6。然后同樣新建系統(tǒng)變量變量名MAVEN_HOME 變量值C:\dev\apache-maven-3.9.6再在Path里加一條%MAVEN_HOME%\bin。注意Windows 改完環(huán)境變量后一定要關(guān)掉所有已經(jīng)打開(kāi)的終端和 VS Code重新打開(kāi)才會(huì)生效。很多人改完發(fā)現(xiàn)沒(méi)反應(yīng)就是因?yàn)榕f終端還在用舊的環(huán)境變量。驗(yàn)證方式和 MAC 一樣打開(kāi)新的 PowerShell 或 CMDjava -version mvn -v2.3 配置 Maven 的 settings.xmlMaven 默認(rèn)從中央倉(cāng)庫(kù)拉依賴(lài)國(guó)內(nèi)訪(fǎng)問(wèn)有時(shí)候會(huì)比較慢。你可以配置一下鏡像加速。Maven 的配置文件在MAC~/.m2/settings.xmlWindowsC:\Users\你的用戶(hù)名\.m2\settings.xml如果.m2目錄不存在就手動(dòng)建一個(gè)。settings.xml 內(nèi)容參考?xml version1.0 encodingUTF-8? settings xmlnshttp://maven.apache.org/SETTINGS/1.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd mirrors mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共倉(cāng)庫(kù)/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors /settings這個(gè)鏡像配置能明顯加快依賴(lài)下載速度。配好之后Maven 的環(huán)境就算完整了。3. VS Code 插件配置與 TaoToken 統(tǒng)一 Key 接入環(huán)境裝好了接下來(lái)是 VS Code 這邊的配置。這一節(jié)包含兩個(gè)部分Java 開(kāi)發(fā)必需的插件以及 AI 輔助編碼的接入配置。3.1 安裝 Java 擴(kuò)展包打開(kāi) VS Code進(jìn)入擴(kuò)展面板快捷鍵CtrlShiftX或 MAC 上CmdShiftX搜索并安裝Extension Pack for Java微軟官方包含語(yǔ)言支持、調(diào)試、測(cè)試、Maven、項(xiàng)目管理等Spring Boot Extension Pack包含 Spring Boot 工具支持裝完這兩個(gè)包VS Code 就具備了完整的 Java Spring Boot 開(kāi)發(fā)能力。裝完之后建議重啟一次 VS Code。3.2 配置 VS Code 的 settings.jsonVS Code 的 Java 配置需要告訴它 JDK 在哪。打開(kāi)設(shè)置Ctrl,或Cmd,點(diǎn)右上角的「打開(kāi)設(shè)置(JSON)」圖標(biāo)或者直接用命令面板輸入Preferences: Open User Settings (JSON)。在 settings.json 里加入以下配置。注意路徑要換成你自己的實(shí)際路徑{ java.jdt.ls.java.home: /opt/homebrew/opt/openjdk17, java.configuration.runtimes: [ { name: JavaSE-17, path: /opt/homebrew/opt/openjdk17, default: true } ], java.configuration.maven.userSettings: /Users/你的用戶(hù)名/.m2/settings.xml, maven.executable.path: /opt/homebrew/bin/mvn, spring-boot.ls.java.home: /opt/homebrew/opt/openjdk17 }Windows 用戶(hù)的路徑要改成對(duì)應(yīng)的 Windows 格式比如{ java.jdt.ls.java.home: C:\\Program Files\\Eclipse Adoptium\\jdk-17.x.x-hotspot, java.configuration.runtimes: [ { name: JavaSE-17, path: C:\\Program Files\\Eclipse Adoptium\\jdk-17.x.x-hotspot, default: true } ], java.configuration.maven.userSettings: C:\\Users\\你的用戶(hù)名\\.m2\\settings.xml, maven.executable.path: C:\\dev\\apache-maven-3.9.6\\bin\\mvn.cmd, spring-boot.ls.java.home: C:\\Program Files\\Eclipse Adoptium\\jdk-17.x.x-hotspot }注意Windows 路徑里的反斜杠要寫(xiě)成雙反斜杠\\這是 JSON 的轉(zhuǎn)義要求。寫(xiě)單反斜杠會(huì)導(dǎo)致配置解析失敗。3.3 接入 TaoToken 統(tǒng)一 Key現(xiàn)在寫(xiě)代碼基本離不開(kāi) AI 輔助。VS Code 里可以用 Continue、Cline 這類(lèi)插件來(lái)接入 AI 模型。但問(wèn)題是不同模型要用不同的 Key管理起來(lái)很麻煩。TaoToken 的思路是提供一個(gè)統(tǒng)一的 API 通道你只需要一個(gè) Key就能調(diào)用多種模型。先獲取 Key。訪(fǎng)問(wèn) TaoToken 的 API Keys 頁(yè)面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite登錄后創(chuàng)建一個(gè)新的 API Key復(fù)制保存好。這個(gè) Key 就是你后面所有 AI 調(diào)用的憑證。然后配置 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意這個(gè)地址后面不加 UTM 參數(shù)直接用作 API 端點(diǎn)。以 Continue 插件為例它的配置文件在~/.continue/config.jsonMAC或C:\Users\你的用戶(hù)名\.continue\config.jsonWindows。配置片段如下{ models: [ { title: TaoToken Claude, provider: openai, model: claude-sonnet-4-20250514, apiBase: https://taotoken.net/api, apiKey: 你的TaoToken Key } ] }這里provider填openai是因?yàn)?TaoToken 的 API 兼容 OpenAI 的調(diào)用格式apiBase指向 TaoToken 的地址model填你想用的模型 ID。這樣配置之后Continue 就會(huì)通過(guò) TaoToken 的通道去調(diào)用模型。如果你用的是 Cline 插件配置方式類(lèi)似在插件的設(shè)置里選擇 OpenAI Compatible然后填入 Base URL 和 Key。Cline 的 MCP 功能也可以配合使用但要注意 MCP 不要直連生產(chǎn)數(shù)據(jù)庫(kù)這是安全底線(xiàn)。提示模型 ID 會(huì)隨著平臺(tái)更新而變化具體可用的模型列表可以在模型對(duì)話(huà)頁(yè)面查看https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite4. 創(chuàng)建 Spring Boot 項(xiàng)目并驗(yàn)證接口連通環(huán)境配好了現(xiàn)在來(lái)創(chuàng)建一個(gè)實(shí)際的 Spring Boot 項(xiàng)目跑起來(lái)看看。4.1 用 Maven 原型創(chuàng)建項(xiàng)目在 VS Code 里按CtrlShiftPMAC 是CmdShiftP打開(kāi)命令面板輸入Spring Initializr選擇「Spring Initializr: Create a Maven Project」。按提示選擇Spring Boot 版本選 3.x 的穩(wěn)定版語(yǔ)言JavaGroup Id比如com.exampleArtifact Id比如demo打包方式JarJava 版本17依賴(lài)勾選 Spring Web選完之后指定一個(gè)保存目錄VS Code 會(huì)自動(dòng)生成項(xiàng)目結(jié)構(gòu)并開(kāi)始下載依賴(lài)。第一次下載依賴(lài)會(huì)比較慢耐心等一會(huì)兒。生成的項(xiàng)目結(jié)構(gòu)大致是demo/ ├── src/ │ ├── main/ │ │ ├── java/com/example/demo/ │ │ │ └── DemoApplication.java │ │ └── resources/ │ │ └── application.properties │ └── test/ ├── pom.xml └── mvnw4.2 檢查 pom.xml打開(kāi)pom.xml確認(rèn)關(guān)鍵部分。一個(gè)典型的 Spring Boot 3.x 的 pom.xml 長(zhǎng)這樣?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.0/version relativePath/ /parent groupIdcom.example/groupId artifactIddemo/artifactId version0.0.1-SNAPSHOT/version namedemo/name properties java.version17/java.version /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /projectjava.version要是 17spring-boot-starter-web是 Web 項(xiàng)目的核心依賴(lài)。4.3 寫(xiě)一個(gè)測(cè)試接口在src/main/java/com/example/demo/下新建一個(gè)HelloController.javapackage com.example.demo; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; RestController public class HelloController { GetMapping(/hello) public String hello() { return Hello from Spring Boot TaoToken; } }4.4 運(yùn)行并驗(yàn)證在 VS Code 的終端里進(jìn)入項(xiàng)目根目錄執(zhí)行mvn spring-boot:run如果一切正常你會(huì)看到控制臺(tái)輸出 Spring Boot 的啟動(dòng)日志最后一行類(lèi)似Started DemoApplication in 2.345 seconds (process running for 3.012)然后打開(kāi)瀏覽器或者用 curl 訪(fǎng)問(wèn)curl http://localhost:8080/hello應(yīng)該返回Hello from Spring Boot TaoToken到這里Maven Spring Boot 的環(huán)境就完全跑通了。同時(shí)你的 VS Code 里也已經(jīng)接入了 TaoToken 的 AI 輔助通道寫(xiě)代碼的時(shí)候可以讓 AI 幫你補(bǔ)全、解釋、生成測(cè)試。5. 常見(jiàn)報(bào)錯(cuò)排查401、local proxy failed、reading choices 等配置過(guò)程中最容易卡住的就是各種報(bào)錯(cuò)。這一節(jié)把常見(jiàn)的幾個(gè)列出來(lái)對(duì)照著排查。5.1 401 Unauthorized這個(gè)報(bào)錯(cuò)通常出現(xiàn)在 AI 調(diào)用環(huán)節(jié)說(shuō)明 Key 不對(duì)或者沒(méi)傳對(duì)。檢查幾點(diǎn)第一確認(rèn)你的 TaoToken Key 復(fù)制完整沒(méi)有多余的空格。第二確認(rèn)apiBase填的是https://taotoken.net/api不要多加斜杠或者路徑。第三確認(rèn)請(qǐng)求頭里的Authorization格式是Bearer 你的Key。如果你用的是 Continue 插件可以在它的日志面板里看到具體的請(qǐng)求信息對(duì)照檢查。5.2 local proxy failed這個(gè)報(bào)錯(cuò)一般和網(wǎng)絡(luò)代理有關(guān)。如果你本地開(kāi)了某些網(wǎng)絡(luò)工具可能會(huì)導(dǎo)致請(qǐng)求被攔截。解決辦法是檢查 VS Code 的代理設(shè)置或者在插件配置里把代理關(guān)掉。在 VS Code 的 settings.json 里可以加{ http.proxy: , http.proxyStrictSSL: false }把代理置空讓請(qǐng)求直連。注意這里說(shuō)的是本地開(kāi)發(fā)環(huán)境的網(wǎng)絡(luò)配置不涉及任何其他用途。5.3 reading choices 相關(guān)報(bào)錯(cuò)這個(gè)報(bào)錯(cuò)通常出現(xiàn)在解析 AI 返回結(jié)果的時(shí)候說(shuō)明返回的 JSON 結(jié)構(gòu)不符合預(yù)期。常見(jiàn)原因是模型 ID 填錯(cuò)了或者 API 格式不兼容。檢查你的model字段是否填了正確的模型 ID。如果用的是 OpenAI 兼容格式確認(rèn)provider填的是openai。另外有些插件對(duì)返回格式有特定要求可以嘗試換一個(gè)模型 ID 測(cè)試。5.4 OAuth 相關(guān)報(bào)錯(cuò)如果你用的是 Claude Code 這類(lèi)工具可能會(huì)遇到 OAuth 認(rèn)證的問(wèn)題。Claude Code 的接入需要配置 Anthropic 的 Base URL 和 Key。在 TaoToken 的文檔里有專(zhuān)門(mén)的 Claude Code 接入說(shuō)明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite按照文檔配置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY環(huán)境變量即可。MAC 上在~/.zshrc里加Windows 上在系統(tǒng)環(huán)境變量里加。5.5 Maven 找不到 JDK這個(gè)報(bào)錯(cuò)在mvn -v的時(shí)候就會(huì)出現(xiàn)提示JAVA_HOME未設(shè)置或者指向錯(cuò)誤?；厝z查環(huán)境變量確認(rèn)JAVA_HOME指向的是 JDK 的根目錄不是bin目錄。MAC 上還要確認(rèn)~/.zshrc已經(jīng) source 過(guò)。5.6 VS Code 里 Java 項(xiàng)目一片紅如果 VS Code 里 Java 文件全是紅色波浪線(xiàn)但命令行mvn能跑通說(shuō)明是 VS Code 的 Java 語(yǔ)言服務(wù)器沒(méi)找到正確的 JDK。檢查 settings.json 里的java.jdt.ls.java.home配置確認(rèn)路徑正確。改完之后重啟 VS Code或者按CtrlShiftP執(zhí)行Java: Clean Java Language Server Workspace。6. 長(zhǎng)期編碼與 Agent 場(chǎng)景的接入建議環(huán)境跑通只是第一步。如果你打算長(zhǎng)期用 VS Code 寫(xiě) Spring Boot并且希望 AI 輔助能更深度地參與進(jìn)來(lái)有幾個(gè)方向可以繼續(xù)折騰。第一是 Coding Plan。TaoToken 提供了面向長(zhǎng)期編碼場(chǎng)景的方案適合需要頻繁調(diào)用 AI 的開(kāi)發(fā)者。相比按次計(jì)費(fèi)Coding Plan 在用量大的時(shí)候更劃算。具體可以看https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite第二是 Agent 場(chǎng)景。如果你想讓 AI 幫你自動(dòng)完成一些編碼任務(wù)比如生成 CRUD 代碼、寫(xiě)單元測(cè)試、重構(gòu)方法可以配合 Cline 這類(lèi)支持 Agent 模式的插件。Cline 的 MCP 功能可以擴(kuò)展 AI 的能力邊界但記住一條MCP 不要直連生產(chǎn)數(shù)據(jù)庫(kù)所有涉及數(shù)據(jù)的操作都要在安全的測(cè)試環(huán)境里進(jìn)行。第三是模型選擇。不同的模型在代碼生成上的表現(xiàn)不一樣。Claude 系列在代碼理解和生成上比較穩(wěn)適合復(fù)雜的重構(gòu)任務(wù)一些輕量模型響應(yīng)快適合日常補(bǔ)全。你可以在 TaoToken 的模型對(duì)話(huà)頁(yè)面測(cè)試不同模型的效果找到最適合自己工作流的組合https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite第四是 Key 管理。TaoToken 的控制臺(tái)可以管理你的 API Key查看用量設(shè)置額度提醒。建議定期檢查用量避免 Key 泄露導(dǎo)致意外消耗https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite最后說(shuō)一個(gè)實(shí)際經(jīng)驗(yàn)VS Code 的 Java 插件在項(xiàng)目依賴(lài)多的時(shí)候會(huì)占用不少內(nèi)存如果你的機(jī)器配置一般可以在 settings.json 里調(diào)整 Java 語(yǔ)言服務(wù)器的內(nèi)存上限{ java.jdt.ls.vmargs: -Xmx2G }這樣能避免語(yǔ)言服務(wù)器頻繁卡頓。配置完之后整個(gè) MAC 或 Windows 下的 VS Code Maven Spring Boot TaoToken 的工作流就完整了。從環(huán)境搭建到 AI 輔助接入再到長(zhǎng)期使用的優(yōu)化這套組合足夠支撐日常的 Java 后端開(kāi)發(fā)。