1. 刚装完 VS Code 却满屏英文？先解决这个场景问题
VS Code 全称 Visual Studio Code，是微软推出的免费代码编辑器，能写 Python、JavaScript、Go、Markdown，也能当轻量级 IDE 用。它适合谁？刚接触编程的新手、从 PyCharm 或 Sublime 转过来的开发者、需要快速改脚本的运维同学，基本都能上手。但很多人第一次打开它，界面全是英文，菜单找不到，插件不知道装哪个，配置项一多就懵。这篇 VS Code 安装教程就按 Windows 和 macOS 两条线，把下载、装中文语言包、装常用插件、写 settings.json 一次讲完，你跟着做就能得到一个能直接写代码的环境。
我试过在 Windows 11 和 macOS Sonoma 上各装一遍，流程差异不大，主要坑在 macOS 的权限弹窗和 Windows 的安装路径选择。下面按步骤来，每一步都给可复制的命令或配置，不跳步。
先说清楚目标：装完之后，你的 VS Code 应该是中文界面，Python 文件能高亮和运行，保存时自动格式化，Git 改动能在侧边栏看到。这三个能力对应三个插件：Chinese Language Pack、Python、Prettier，再加一个 GitLens 看提交历史。插件不在多，先把这四个跑通，后面按需加。
下载地址只认官网 code.visualstudio.com，别去第三方站下，容易捆东西。Windows 选 User Installer 64-bit，macOS 选 Apple Silicon 或 Intel 对应版本。装的时候 Windows 建议换到 D 盘，路径别带中文和空格，比如D:\VSCode，不然后面某些插件读路径会出问题。macOS 直接把 app 拖进 Applications 就行。
装完第一次启动，Windows 会问你要不要关联文件类型，全勾上；macOS 会弹一个“是否信任从互联网下载的 App”，点打开。到这里编辑器能用了，但界面还是英文，下一步解决中文。
2. TaoToken 前置准备：给 VS Code 接上模型能力
VS Code 本身是编辑器，不内置大模型。你想在编辑器里用 AI 补全、对话、改代码，需要接一个模型服务。TaoToken 提供的就是这个能力，它兼容 OpenAI 风格的接口，VS Code 里几个主流 AI 插件都能直接填 Base URL 和 Key 用起来。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 地址后面不加 UTM 参数，填配置的时候别带多余后缀。
为什么要在装 VS Code 的教程里提这个？因为很多人装完编辑器第一件事就是找 AI 插件，而插件装完卡在“填 API Key”这一步。提前把 Key 拿到，后面插件配置直接粘贴，不用来回翻文档。你需要准备三样东西：Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api，Key 在控制台生成，Model ID 按你用的模型填，比如claude-sonnet-4-20250514这类。
获取 Key 的路径：打开 https://taotoken.net/console ，登录后进 API Keys 页面，点创建，复制那串 sk- 开头的字符串。这个 Key 只显示一次，先存到记事本。如果你还没决定用哪个模型，可以先去模型对话页面试一下 https://taotoken.net/model ，看看响应速度和输出风格，再决定在 VS Code 里配哪个 Model ID。
这里有个细节：VS Code 的 AI 插件分两类，一类是补全型（比如 Continue、Cline），一类是对话型（比如 CodeGPT）。它们配置项名字不一样，但核心都是 Base URL + Key + Model ID 三件套。你先把这三样准备好，后面不管装哪个插件，填进去就能用。Coding Plan 适合长期写代码、跑 Agent 的场景，如果你只是偶尔问几句，用按量计费就行，具体在 console 里能看到。
注意：TaoToken 是模型服务入口，不是编辑器替代品，VS Code 该装的插件、该写的配置一样不能少。下面第三节先讲 VS Code 本体配置，第四节再讲怎么验证模型请求通不通。
3. 可复制配置：settings.json 与插件清单
这一节给可直接粘贴的配置。VS Code 的用户设置文件路径：Windows 是%APPDATA%\Code\User\settings.json，macOS 是~/Library/Application Support/Code/User/settings.json。你也可以在编辑器里按Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Open User Settings (JSON)直接打开。
先装中文语言包。按Ctrl+Shift+X打开扩展面板，搜索Chinese，找到Chinese (Simplified) Language Pack for Visual Studio Code，点 Install。装完右下角会弹提示，点 Restart 重启，界面就变中文了。如果没弹，手动按Ctrl+Shift+P输入Configure Display Language，选zh-cn，再重启。
插件清单（在扩展面板搜索安装）：
- Python（Microsoft 官方，提供语法高亮、调试、Jupyter）
- Prettier - Code formatter（保存自动格式化）
- GitLens（看每行代码的提交记录）
- Continue（接 TaoToken 做 AI 补全和对话）
装完插件后，把下面这段 settings.json 粘进去。注意路径里的反斜杠在 JSON 里要写成双反斜杠，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.*三项是给 Continue 插件用的，Base URL 填https://taotoken.net/api，Key 换成你控制台生成的那串，Model ID 按实际填。如果你用 Cline，配置项名字换成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 会自动生效。如果 Prettier 没起作用，检查右下角状态栏有没有显示 Prettier，没有的话按Ctrl+Shift+P输入Format Document With，选 Prettier 设为默认。Python 解释器如果没识别到，按Ctrl+Shift+P输入Python: Select Interpreter，选你系统里的 python 路径。
4. 验证请求：中文界面生效与插件加载检查
配置写完要验证，不然你不知道哪一步没生效。分三个检查点。
第一，中文界面。重启 VS Code 后，看左上角菜单是不是“文件、编辑、查看、终端、帮助”。如果是，说明语言包生效。如果还是英文，按Ctrl+Shift+P输入Display Language，看当前是不是zh-cn，不是就改，然后完全退出再打开。macOS 要按Cmd+Q彻底退出，不是关窗口。
第二，插件加载。按Ctrl+Shift+X打开扩展面板，看已安装列表里 Python、Prettier、GitLens、Continue 是不是都显示“已安装”且没有报错图标。如果有黄色感叹号，点进去看提示，通常是版本不兼容，点“重新加载”或更新即可。Python 插件装好后，新建一个test.py，输入print("hello")，右下角应该显示 Python 版本号，按F5能运行并输出。
第三，模型请求。打开 Continue 插件面板（左侧边栏有个 Continue 图标），在对话框输入“写一个 Python 冒泡排序”，回车。如果返回代码，说明 Base URL 和 Key 填对了。如果报错，看下面第五节。你也可以用命令行验证，在终端执行：
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字段就说明通了。这一步能排除是插件问题还是 Key 问题。如果 curl 通但插件不通，就是插件配置项名字写错了，回去检查 settings.json 里的continue.serverUrl有没有拼错。
实测下来，最容易卡住的是 Key 复制时带了空格，或者 Base URL 末尾多加了斜杠。https://taotoken.net/api后面不要加/v1，插件会自动补。如果你用的是 Cline，它可能要求填https://taotoken.net/api/v1，以插件文档为准，但核心地址不变。
5. 常见报错排查：401、local proxy failed、reading choices
这一节列真实会遇到的报错和对应处理。
401 Unauthorized：Key 错了或没填。检查 settings.json 里continue.apiKey是不是完整的 sk- 开头字符串，有没有换行或空格。去 console 重新生成一个 Key 再试。如果用的是环境变量，确认变量名和插件要求一致。
local proxy failed / connection refused：插件试图走本地代理但没起来。检查你有没有在 VS Code 设置里配http.proxy，如果配了但代理没开，就会报这个。解决：Ctrl+,打开设置，搜索proxy，把Http: Proxy清空，或者设成https://taotoken.net/api对应的直连。macOS 还要检查系统网络设置里有没有全局代理。
reading 'choices' / undefined is not an object：接口返回了但结构不对，通常是 Model ID 写错，或者 Base URL 指到了错误路径。确认 Model ID 是控制台里列出的可用模型，Base URL 是https://taotoken.net/api。如果返回的是 HTML 而不是 JSON，说明地址被重定向了，检查有没有多写路径。
OAuth / token expired：如果你用的是 Codex 或 Claude Code 这类带 OAuth 的工具，token 过期会报这个。重新走一遍授权，或者改用 API Key 方式。Codex 的 auth.json 里如果同时有 oauth 和 api_key 字段，优先用 api_key。
插件装了但没反应：按Ctrl+Shift+P输入Developer: Reload Window重载窗口。还不行就看扩展面板里插件的输出日志，点插件详情页的“输出”标签，能看到具体错误。
中文包装了但部分菜单还是英文：正常，有些插件自己的界面不跟随语言包。只要主菜单和设置界面是中文就行。如果完全没变，检查locale.json路径，Windows 在%APPDATA%\Code\User\locale.json，内容应该是{"locale":"zh-cn"}。
排障顺序建议：先 curl 验证 Key 和地址，再检查插件配置项，最后看 VS Code 输出日志。三步能定位 90% 的问题。
6. 接下来怎么用：从装好到顺手
装完这一套，你的 VS Code 已经能写 Python、自动格式化、看 Git 历史、接模型对话。下一步按需加插件：写前端加 ESLint、写 Markdown 加 Markdown All in One、写 Docker 加 Docker 插件。但别一次装太多，插件之间会抢快捷键，先把手头四个用熟。
如果你要长期在 VS Code 里跑 Agent 或做大量代码生成，去 https://taotoken.net/coding-plan 看 Coding Plan，比按量计费更适合高频场景。需要管理 Key 和查看用量，在 https://taotoken.net/console 操作。API 文档在 https://taotoken.net/doc ，里面有各语言调用示例。想先试模型效果，直接开 https://taotoken.net/model 对话。
最后给一个实用技巧：把 settings.json 用 Git 管起来，换电脑时直接同步，不用重配。路径里的 Key 用环境变量替代，比如"continue.apiKey": "${env:TAOTOKEN_KEY}"，然后在系统环境变量里设TAOTOKEN_KEY，这样配置文件能公开分享也不泄露 Key。VS Code 支持${env:VAR}语法，Python、Node 插件都认。
