1. 剛裝完 VS Code 卻滿(mǎn)屏英文先解決這個(gè)場(chǎng)景問(wèn)題VS Code 全稱(chēng) Visual Studio Code是微軟推出的免費(fèi)代碼編輯器能寫(xiě) Python、JavaScript、Go、Markdown也能當(dāng)輕量級(jí) IDE 用。它適合誰(shuí)剛接觸編程的新手、從 PyCharm 或 Sublime 轉(zhuǎn)過(guò)來(lái)的開(kāi)發(fā)者、需要快速改腳本的運(yùn)維同學(xué)基本都能上手。但很多人第一次打開(kāi)它界面全是英文菜單找不到插件不知道裝哪個(gè)配置項(xiàng)一多就懵。這篇 VS Code 安裝教程就按 Windows 和 macOS 兩條線把下載、裝中文語(yǔ)言包、裝常用插件、寫(xiě) settings.json 一次講完你跟著做就能得到一個(gè)能直接寫(xiě)代碼的環(huán)境。我試過(guò)在 Windows 11 和 macOS Sonoma 上各裝一遍流程差異不大主要坑在 macOS 的權(quán)限彈窗和 Windows 的安裝路徑選擇。下面按步驟來(lái)每一步都給可復(fù)制的命令或配置不跳步。先說(shuō)清楚目標(biāo)裝完之后你的 VS Code 應(yīng)該是中文界面Python 文件能高亮和運(yùn)行保存時(shí)自動(dòng)格式化Git 改動(dòng)能在側(cè)邊欄看到。這三個(gè)能力對(duì)應(yīng)三個(gè)插件Chinese Language Pack、Python、Prettier再加一個(gè) GitLens 看提交歷史。插件不在多先把這四個(gè)跑通后面按需加。下載地址只認(rèn)官網(wǎng) code.visualstudio.com別去第三方站下容易捆東西。Windows 選 User Installer 64-bitmacOS 選 Apple Silicon 或 Intel 對(duì)應(yīng)版本。裝的時(shí)候 Windows 建議換到 D 盤(pán)路徑別帶中文和空格比如D:\VSCode不然后面某些插件讀路徑會(huì)出問(wèn)題。macOS 直接把 app 拖進(jìn) Applications 就行。裝完第一次啟動(dòng)Windows 會(huì)問(wèn)你要不要關(guān)聯(lián)文件類(lèi)型全勾上macOS 會(huì)彈一個(gè)“是否信任從互聯(lián)網(wǎng)下載的 App”點(diǎn)打開(kāi)。到這里編輯器能用了但界面還是英文下一步解決中文。2. TaoToken 前置準(zhǔn)備給 VS Code 接上模型能力VS Code 本身是編輯器不內(nèi)置大模型。你想在編輯器里用 AI 補(bǔ)全、對(duì)話、改代碼需要接一個(gè)模型服務(wù)。TaoToken 提供的就是這個(gè)能力它兼容 OpenAI 風(fēng)格的接口VS Code 里幾個(gè)主流 AI 插件都能直接填 Base URL 和 Key 用起來(lái)。官網(wǎng)地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 參數(shù)填配置的時(shí)候別帶多余后綴。為什么要在裝 VS Code 的教程里提這個(gè)因?yàn)楹芏嗳搜b完編輯器第一件事就是找 AI 插件而插件裝完卡在“填 API Key”這一步。提前把 Key 拿到后面插件配置直接粘貼不用來(lái)回翻文檔。你需要準(zhǔn)備三樣?xùn)|西Base URL、API Key、Model ID。Base URL 填https://taotoken.net/apiKey 在控制臺(tái)生成Model ID 按你用的模型填比如claude-sonnet-4-20250514這類(lèi)。獲取 Key 的路徑打開(kāi) https://taotoken.net/console 登錄后進(jìn) API Keys 頁(yè)面點(diǎn)創(chuàng)建復(fù)制那串 sk- 開(kāi)頭的字符串。這個(gè) Key 只顯示一次先存到記事本。如果你還沒(méi)決定用哪個(gè)模型可以先去模型對(duì)話頁(yè)面試一下 https://taotoken.net/model 看看響應(yīng)速度和輸出風(fēng)格再?zèng)Q定在 VS Code 里配哪個(gè) Model ID。這里有個(gè)細(xì)節(jié)VS Code 的 AI 插件分兩類(lèi)一類(lèi)是補(bǔ)全型比如 Continue、Cline一類(lèi)是對(duì)話型比如 CodeGPT。它們配置項(xiàng)名字不一樣但核心都是 Base URL Key Model ID 三件套。你先把這三樣準(zhǔn)備好后面不管裝哪個(gè)插件填進(jìn)去就能用。Coding Plan 適合長(zhǎng)期寫(xiě)代碼、跑 Agent 的場(chǎng)景如果你只是偶爾問(wèn)幾句用按量計(jì)費(fèi)就行具體在 console 里能看到。注意TaoToken 是模型服務(wù)入口不是編輯器替代品VS Code 該裝的插件、該寫(xiě)的配置一樣不能少。下面第三節(jié)先講 VS Code 本體配置第四節(jié)再講怎么驗(yàn)證模型請(qǐng)求通不通。3. 可復(fù)制配置settings.json 與插件清單這一節(jié)給可直接粘貼的配置。VS Code 的用戶(hù)設(shè)置文件路徑Windows 是%APPDATA%\Code\User\settings.jsonmacOS 是~/Library/Application Support/Code/User/settings.json。你也可以在編輯器里按CtrlShiftPmacOS 是CmdShiftP輸入Open User Settings (JSON)直接打開(kāi)。先裝中文語(yǔ)言包。按CtrlShiftX打開(kāi)擴(kuò)展面板搜索Chinese找到Chinese (Simplified) Language Pack for Visual Studio Code點(diǎn) Install。裝完右下角會(huì)彈提示點(diǎn) Restart 重啟界面就變中文了。如果沒(méi)彈手動(dòng)按CtrlShiftP輸入Configure Display Language選zh-cn再重啟。插件清單在擴(kuò)展面板搜索安裝PythonMicrosoft 官方提供語(yǔ)法高亮、調(diào)試、JupyterPrettier - Code formatter保存自動(dòng)格式化GitLens看每行代碼的提交記錄Continue接 TaoToken 做 AI 補(bǔ)全和對(duì)話裝完插件后把下面這段 settings.json 粘進(jìn)去。注意路徑里的反斜杠在 JSON 里要寫(xiě)成雙反斜杠macOS 用正斜杠。{ workbench.colorTheme: Default Dark Modern, editor.fontSize: 14, editor.tabSize: 4, editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode, files.autoSave: afterDelay, python.defaultInterpreterPath: python, python.formatting.provider: none, [python]: { editor.defaultFormatter: ms-python.python }, git.enableSmartCommit: true, git.autofetch: true, continue.serverUrl: https://taotoken.net/api, continue.apiKey: sk-你的Key粘貼到這里, continue.model: claude-sonnet-4-20250514 }上面continue.*三項(xiàng)是給 Continue 插件用的Base URL 填https://taotoken.net/apiKey 換成你控制臺(tái)生成的那串Model ID 按實(shí)際填。如果你用 Cline配置項(xiàng)名字換成cline.apiProvider、cline.apiKey、cline.model值一樣。Codex 的 auth.json 路徑在~/.codex/auth.json里面填{api_key: sk-..., base_url: https://taotoken.net/api}這是給命令行工具用的和 VS Code 插件不沖突。保存 settings.json 后VS Code 會(huì)自動(dòng)生效。如果 Prettier 沒(méi)起作用檢查右下角狀態(tài)欄有沒(méi)有顯示 Prettier沒(méi)有的話按CtrlShiftP輸入Format Document With選 Prettier 設(shè)為默認(rèn)。Python 解釋器如果沒(méi)識(shí)別到按CtrlShiftP輸入Python: Select Interpreter選你系統(tǒng)里的 python 路徑。4. 驗(yàn)證請(qǐng)求中文界面生效與插件加載檢查配置寫(xiě)完要驗(yàn)證不然你不知道哪一步?jīng)]生效。分三個(gè)檢查點(diǎn)。第一中文界面。重啟 VS Code 后看左上角菜單是不是“文件、編輯、查看、終端、幫助”。如果是說(shuō)明語(yǔ)言包生效。如果還是英文按CtrlShiftP輸入Display Language看當(dāng)前是不是zh-cn不是就改然后完全退出再打開(kāi)。macOS 要按CmdQ徹底退出不是關(guān)窗口。第二插件加載。按CtrlShiftX打開(kāi)擴(kuò)展面板看已安裝列表里 Python、Prettier、GitLens、Continue 是不是都顯示“已安裝”且沒(méi)有報(bào)錯(cuò)圖標(biāo)。如果有黃色感嘆號(hào)點(diǎn)進(jìn)去看提示通常是版本不兼容點(diǎn)“重新加載”或更新即可。Python 插件裝好后新建一個(gè)test.py輸入print(hello)右下角應(yīng)該顯示 Python 版本號(hào)按F5能運(yùn)行并輸出。第三模型請(qǐng)求。打開(kāi) Continue 插件面板左側(cè)邊欄有個(gè) Continue 圖標(biāo)在對(duì)話框輸入“寫(xiě)一個(gè) Python 冒泡排序”回車(chē)。如果返回代碼說(shuō)明 Base URL 和 Key 填對(duì)了。如果報(bào)錯(cuò)看下面第五節(jié)。你也可以用命令行驗(yàn)證在終端執(zhí)行curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:hi}]}返回 JSON 里有choices字段就說(shuō)明通了。這一步能排除是插件問(wèn)題還是 Key 問(wèn)題。如果 curl 通但插件不通就是插件配置項(xiàng)名字寫(xiě)錯(cuò)了回去檢查 settings.json 里的continue.serverUrl有沒(méi)有拼錯(cuò)。實(shí)測(cè)下來(lái)最容易卡住的是 Key 復(fù)制時(shí)帶了空格或者 Base URL 末尾多加了斜杠。https://taotoken.net/api后面不要加/v1插件會(huì)自動(dòng)補(bǔ)。如果你用的是 Cline它可能要求填https://taotoken.net/api/v1以插件文檔為準(zhǔn)但核心地址不變。5. 常見(jiàn)報(bào)錯(cuò)排查401、local proxy failed、reading choices這一節(jié)列真實(shí)會(huì)遇到的報(bào)錯(cuò)和對(duì)應(yīng)處理。401 UnauthorizedKey 錯(cuò)了或沒(méi)填。檢查 settings.json 里continue.apiKey是不是完整的 sk- 開(kāi)頭字符串有沒(méi)有換行或空格。去 console 重新生成一個(gè) Key 再試。如果用的是環(huán)境變量確認(rèn)變量名和插件要求一致。local proxy failed / connection refused插件試圖走本地代理但沒(méi)起來(lái)。檢查你有沒(méi)有在 VS Code 設(shè)置里配http.proxy如果配了但代理沒(méi)開(kāi)就會(huì)報(bào)這個(gè)。解決Ctrl,打開(kāi)設(shè)置搜索proxy把Http: Proxy清空或者設(shè)成https://taotoken.net/api對(duì)應(yīng)的直連。macOS 還要檢查系統(tǒng)網(wǎng)絡(luò)設(shè)置里有沒(méi)有全局代理。reading choices / undefined is not an object接口返回了但結(jié)構(gòu)不對(duì)通常是 Model ID 寫(xiě)錯(cuò)或者 Base URL 指到了錯(cuò)誤路徑。確認(rèn) Model ID 是控制臺(tái)里列出的可用模型Base URL 是https://taotoken.net/api。如果返回的是 HTML 而不是 JSON說(shuō)明地址被重定向了檢查有沒(méi)有多寫(xiě)路徑。OAuth / token expired如果你用的是 Codex 或 Claude Code 這類(lèi)帶 OAuth 的工具token 過(guò)期會(huì)報(bào)這個(gè)。重新走一遍授權(quán)或者改用 API Key 方式。Codex 的 auth.json 里如果同時(shí)有 oauth 和 api_key 字段優(yōu)先用 api_key。插件裝了但沒(méi)反應(yīng)按CtrlShiftP輸入Developer: Reload Window重載窗口。還不行就看擴(kuò)展面板里插件的輸出日志點(diǎn)插件詳情頁(yè)的“輸出”標(biāo)簽?zāi)芸吹骄唧w錯(cuò)誤。中文包裝了但部分菜單還是英文正常有些插件自己的界面不跟隨語(yǔ)言包。只要主菜單和設(shè)置界面是中文就行。如果完全沒(méi)變檢查locale.json路徑Windows 在%APPDATA%\Code\User\locale.json內(nèi)容應(yīng)該是{locale:zh-cn}。排障順序建議先 curl 驗(yàn)證 Key 和地址再檢查插件配置項(xiàng)最后看 VS Code 輸出日志。三步能定位 90% 的問(wèn)題。6. 接下來(lái)怎么用從裝好到順手裝完這一套你的 VS Code 已經(jīng)能寫(xiě) Python、自動(dòng)格式化、看 Git 歷史、接模型對(duì)話。下一步按需加插件寫(xiě)前端加 ESLint、寫(xiě) Markdown 加 Markdown All in One、寫(xiě) Docker 加 Docker 插件。但別一次裝太多插件之間會(huì)搶快捷鍵先把手頭四個(gè)用熟。如果你要長(zhǎng)期在 VS Code 里跑 Agent 或做大量代碼生成去 https://taotoken.net/coding-plan 看 Coding Plan比按量計(jì)費(fèi)更適合高頻場(chǎng)景。需要管理 Key 和查看用量在 https://taotoken.net/console 操作。API 文檔在 https://taotoken.net/doc 里面有各語(yǔ)言調(diào)用示例。想先試模型效果直接開(kāi) https://taotoken.net/model 對(duì)話。最后給一個(gè)實(shí)用技巧把 settings.json 用 Git 管起來(lái)?yè)Q電腦時(shí)直接同步不用重配。路徑里的 Key 用環(huán)境變量替代比如continue.apiKey: ${env:TAOTOKEN_KEY}然后在系統(tǒng)環(huán)境變量里設(shè)TAOTOKEN_KEY這樣配置文件能公開(kāi)分享也不泄露 Key。VS Code 支持${env:VAR}語(yǔ)法Python、Node 插件都認(rèn)。