从零开始的 VS Code Python 环境配置：uv + TaoToken 统一 Key 接入

1. 从零搭建 VS Code Python 环境为什么我推荐 uv TaoToken如果你刚开始学 Python大概率经历过这样的场景装好 VS Code装完 Python 扩展点开左侧那个蟒蛇图标结果弹出一句「没有找到 uv」。你按提示点了安装PATH 也加了VS Code 重启了三次它还是说找不到。这不是你操作有问题而是 VS Code 的 Python 扩展和 uv 之间的路径发现机制跟系统环境变量并不是一回事。这篇内容聚焦一件事在一台干净的机器上用 uv 把 Python 解释器、虚拟环境、依赖管理一次性理顺再通过 TaoToken 的统一 Key 把 AI 编程助手接进 VS Code。适合谁适合刚接触 Python、被环境配置劝退过、又想顺手用上 AI 补全和对话的人。全程可复制命令和配置文件我都会给完整骨架你照着敲就行。uv 是什么一句话用 Rust 写的 Python 工具链能装 Python 版本类似 pyenv、能建虚拟环境类似 venv、能装包类似 pip而且快得离谱。TaoToken 在这里的角色是统一 API 通道你只需要一个 Key就能在 VS Code 里调用模型做代码补全、解释报错、生成测试。两者组合起来环境干净AI 接入也不用来回换配置。2. 前置准备TaoToken Key 与 uv 安装2.1 拿到统一 Key先到 TaoToken 控制台创建一个 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 登录后在 API Keys 页面点新建复制那串以sk-开头的字符串先存到记事本里。这个 Key 后面会同时用在 VS Code 的 AI 插件配置和命令行测试里。注意Key 只显示一次关掉页面就看不到了。如果你不确定放哪先建一个%USERPROFILE%\.taotoken\key.txt临时存着配完再删。2.2 安装 uvWindows 下打开 PowerShell普通权限即可不需要管理员执行官方安装脚本powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iexmacOS 或 Linux 用curl -LsSf https://astral.sh/uv/install.sh | sh装完后uv 默认落在%USERPROFILE%\.local\binWindows或~/.local/binmacOS/Linux。这个目录必须进 PATH否则 VS Code 终端里敲uv会提示找不到命令。Windows 下可以这样加$uvPath $env:USERPROFILE\.local\bin [Environment]::SetEnvironmentVariable(Path, $env:Path ;$uvPath, User)加完关掉所有终端窗口重新开一个执行uv --version能看到版本号就说明 PATH 生效了。这一步没做的话后面 VS Code 里所有 uv 命令都会失败。3. 可复制配置settings.json 与 config.toml 骨架3.1 用 uv 初始化项目先建一个项目目录比如D:\code\demo-py在终端里进去执行uv init demo-py cd demo-py uv python install 3.12 uv venv --python 3.12uv init会生成pyproject.toml和.python-versionuv python install把指定版本的 Python 装到 uv 自己的目录里uv venv在当前目录创建.venv。这三步做完你的项目就有了独立的解释器和虚拟环境跟系统 Python 完全隔离。装依赖用uv add比如uv add requests openai它会自动写进pyproject.toml的dependencies同时更新uv.lock。以后别人拿到你的项目只要执行uv sync依赖和 Python 版本都会按 lock 文件还原不会出现「我这能跑你那报错」的情况。3.2 VS Code 的 settings.json在项目根目录建.vscode/settings.json内容如下{ python.defaultInterpreterPath: ${workspaceFolder}/.venv/Scripts/python.exe, python.terminal.activateEnvironment: true, python.analysis.typeCheckingMode: basic, editor.formatOnSave: true, editor.rulers: [88], files.exclude: { **/__pycache__: true, **/.pytest_cache: true } }macOS/Linux 用户把Scripts/python.exe改成bin/python。python.defaultInterpreterPath指向.venv里的解释器这样 VS Code 的 Python 扩展就不会再去满系统找 Python也不会因为找不到 uv 而弹提示。python.terminal.activateEnvironment保证你打开集成终端时自动激活虚拟环境。3.3 TaoToken 的 config.toml 骨架如果你用的是支持 OpenAI 兼容接口的 AI 编程插件比如 Continue、Cline 这类配置通常放在用户目录下的config.toml或插件自己的设置里。以 Continue 为例在~/.continue/config.json里写{ models: [ { title: TaoToken, provider: openai, model: gpt-4o-mini, apiKey: sk-你的Key, apiBase: https://taotoken.net/api } ] }如果你更习惯 TOML 格式的配置部分工具支持骨架长这样[model] provider openai model gpt-4o-mini api_key sk-你的Key api_base https://taotoken.net/apiapi_base这里填https://taotoken.net/api不要加多余的路径后缀。模型名按你实际要用的填TaoToken 支持多种模型具体列表在文档里查 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。4. 验证请求确认环境和 AI 调用都生效4.1 验证 Python 环境在项目里建main.py写import sys import requests print(sys.executable) print(requests.__version__)在 VS Code 集成终端里执行uv run main.py。uv run会自动用.venv里的解释器不需要你手动激活。输出应该类似D:\code\demo-py\.venv\Scripts\python.exe 2.32.3如果第一行显示的是系统 Python 路径而不是.venv里的说明settings.json没生效检查一下文件位置和 JSON 语法。4.2 验证 TaoToken 调用用命令行直接测一次 API确认 Key 和通道都通curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: gpt-4o-mini, messages: [{role: user, content: 用一句话解释什么是虚拟环境}] }返回 JSON 里如果有choices字段和一段正常回复说明 Key 有效、通道正常。如果返回 401检查 Key 有没有复制全返回 404检查api_base是不是写成了https://taotoken.net/api/v1之外的多余路径。回到 VS Code打开 AI 插件的对话面板输入「帮我给 main.py 加一个读取环境变量的函数」看它能不能正常返回代码。能返回整条链路就通了。5. 本篇常见错排查5.1 VS Code 提示「没有找到 uv」这是最高频的问题。原因通常有三个一是 uv 的安装目录没进 PATH二是 VS Code 没有重新加载环境变量三是 Python 扩展缓存了旧的解释器路径。解决办法先在系统终端确认uv --version能输出然后完全退出 VS Code不是关窗口是任务管理器里确认进程结束再重新打开。如果还不行在命令面板执行Python: Select Interpreter手动选.venv里的解释器。5.2uv run报找不到 Python 版本说明uv python install没执行或者.python-version里写的版本跟已安装的对不上。执行uv python list看已装了哪些版本再用uv python install 3.12补装。.python-version文件里只写版本号比如3.12不要写python-3.12。5.3 API 返回 401 或 403Key 错了或者没带Bearer前缀。检查Authorization头是不是Bearer sk-xxx格式中间有一个空格。另外确认 Key 没有过期在控制台重新生成一个再试。5.4 插件里模型名报错不同插件对模型名的写法要求不一样有的要gpt-4o-mini有的要openai/gpt-4o-mini。以 TaoToken 文档里的模型标识为准别自己猜。文档地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。5.5 虚拟环境激活了但装包还是装到全局大概率是终端里which pythonWindows 用where python指向的不是.venv。用uv run代替手动激活或者执行.venv\Scripts\activateWindows/source .venv/bin/activatemacOS/Linux后再操作。养成用uv add而不是pip install的习惯依赖会统一进pyproject.toml。6. 把 AI 助手接进日常编码流环境配好之后日常写代码的流程会变成这样打开项目VS Code 自动识别.venv终端里uv run直接跑脚本AI 插件在侧边栏随时待命。遇到报错选中错误信息让 AI 解释写新函数让它生成骨架再自己改写测试让它按现有代码风格补用例。如果你打算长期在 VS Code 里用 AI 做编码和 Agent 任务可以了解一下 Coding Plan它针对高频调用场景做了额度优化 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。只是想先试试模型对话效果直接开模型对话页就行 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。Key 管理和新建都在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。最后说一个我踩过的坑.venv目录不要提交到 Git在.gitignore里加上.venv/和__pycache__/。别人克隆你的项目后执行uv sync就能还原一模一样的环境比传虚拟环境目录靠谱得多。