1. VS Code 里 Python 测试跑完没结果先分清是框架问题还是链路问题你在 VS Code 里点下测试侧边栏那个绿色三角终端一闪而过测试树纹丝不动输出面板干干净净——这种「测试不显示结果」的情况我遇到过太多次。它最迷惑人的地方在于VS Code 不会告诉你它到底卡在哪一步是 pytest 根本没被发现还是测试跑完了但结果没回传又或者是你代码里某个请求把整个进程挂住了。先把问题拆开看。VS Code 的 Python 测试本质上是三层协作第一层是测试发现discoveryVS Code 调用 pytest 或 unittest 去扫描你的测试文件把用例列进测试树第二层是测试执行execution你点运行后它真正跑用例第三层是结果回传reporting跑完的结果通过特定协议送回 UI。任何一层断了你看到的都是「没结果」。而这三层里最容易被忽略的是第三层背后的网络环节。很多测试用例本身会调用外部 API——比如你写了个测试去验证某个模型接口返回格式对不对或者测试里 import 了一个会发请求的模块。这时候如果网络通道不通pytest 进程会卡在 socket 等待上VS Code 的测试 UI 就一直转圈或者干脆空白。你以为是测试框架配置错了其实是请求根本没回来。所以排查顺序应该是先确认测试框架有没有被正确发现再确认用例能不能在终端里独立跑通最后确认涉及网络请求的测试是不是卡在链路上。前两步是 VS Code 配置问题第三步往往需要你有一个稳定、可观测的 API 通道来验证。这也是为什么我会在排查流程里引入 TaoToken——它提供一个统一的 Key 和 API 入口让你能快速判断「到底是我的测试代码写错了还是请求发不出去」。下面按这个思路从环境确认到配置落地再到用 TaoToken 验证链路一步步走完。你不需要一次全做完哪一步卡住就停在哪一步深挖。2. 用 TaoToken 统一 Key 与 API 通道先把模型调用链路验证清楚在动 VS Code 配置之前我建议你先花五分钟把「网络请求能不能通」这件事单独验证掉。原因很简单如果你的测试用例里涉及任何模型调用而你又没有一条干净的验证通道后面所有排查都是盲猜。TaoToken 在这里的角色就是一个统一的 API 入口——你拿到一个 Key配好 Base URL就能用标准接口发请求不用在多个平台之间来回切换。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个新的 API Key。建议按用途命名比如vscode-pytest-debug这样后面如果要在多个项目里用不会搞混。Key 创建后只显示一次复制下来存到安全的地方。拿到 Key 之后你需要知道两个地址。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基地址是 https://taotoken.net/api 。注意 API 地址后面不加任何 UTM 参数保持干净。这个 Base URL 就是你后面在测试代码或环境变量里要填的值。为什么这一步对排查测试问题有帮助因为你可以写一个最小的独立脚本不依赖 pytest直接发一个请求看返回。如果这个脚本能通说明你的 Key 和网络没问题那 VS Code 测试不显示结果就大概率是框架配置或测试代码本身的问题如果这个脚本都不通那先解决链路别在 VS Code 里浪费时间。我试过在排查一个「测试树一直空白」的问题时就是先用这个方式确认了 API 通道正常然后回头发现是 pytest 的testpaths配错了目录。如果没有这一步我可能会一直以为是网络问题反复折腾代理设置。另外如果你后面要做的是长期编码或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它适合需要持续调用模型的场景和单次排查用的按量 Key 是互补的。排查阶段先用按量 Key 就够了。模型对话入口在这里https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 你可以先在网页上手动发一条消息确认账号和模型都正常再去写代码。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有完整的请求示例和参数说明遇到字段不确定的时候翻一下比猜快。3. settings.json 可复制配置pytest 发现、执行与结果回传现在进入 VS Code 本身的配置。打开你的工作区按CtrlShiftPmacOS 是CmdShiftP输入Preferences: Open Workspace Settings (JSON)这会打开当前工作区的settings.json。用工作区级别而不是用户级别是因为测试配置通常和项目绑定换项目不该互相干扰。下面是一份可以直接复制的配置我按 pytest 为主、unittest 为备的方式写你按自己项目选一部分{ python.testing.pytestEnabled: true, python.testing.unittestEnabled: false, python.testing.pytestArgs: [ tests, -v, -s, --tbshort ], python.testing.cwd: ${workspaceFolder}, python.testing.autoTestDiscoverOnSaveEnabled: true, python.testing.promptToConfigure: false, python.defaultInterpreterPath: ${workspaceFolder}/.venv/bin/python }逐项说下为什么这么配。pytestEnabled设为 true 是前提如果你同时开了 unittestVS Code 可能会在两种框架之间摇摆导致测试树显示混乱。pytestArgs里的tests是测试目录-v让输出更详细-s允许 print 输出直接打到终端排查时特别有用不然你 print 的东西会被 pytest 捕获--tbshort让报错堆栈短一点方便在输出面板里看。cwd设成${workspaceFolder}很关键。很多人测试发现失败是因为 pytest 的工作目录不对导致相对路径 import 失败。固定在工作区根目录能避免这个问题。autoTestDiscoverOnSaveEnabled设为 true 后你保存测试文件时 VS Code 会自动重新发现用例省得手动点刷新。promptToConfigure设为 false 是关掉那个烦人的「是否配置测试框架」弹窗避免误点。defaultInterpreterPath指向你项目里的虚拟环境。如果你用的是 conda 或者系统 Python把路径换成对应的。Windows 下路径类似${workspaceFolder}\\.venv\\Scripts\\python.exe。这个路径一定要确认存在解释器选错是测试不显示的常见原因之一。如果你用的是 unittest把上面改成{ python.testing.pytestEnabled: false, python.testing.unittestEnabled: true, python.testing.unittestArgs: [ -v, -s, ./tests, -p, *test*.py ], python.testing.cwd: ${workspaceFolder} }unittest 的-s指定测试目录-p指定文件名模式。注意 unittest 的参数格式和 pytest 不一样别混用。配完之后按CtrlShiftP运行Python: Configure Tests选 pytest 或 unittest再选测试目录。这一步会触发一次发现。如果测试树还是空的打开输出面板CtrlShiftU在下拉里选Python Test Log里面会有发现过程的详细日志报错信息通常直接指向问题。还有一个容易漏的点如果你的测试文件里 import 了项目内的模块确保工作区根目录在sys.path里。可以在settings.json里加{ python.analysis.extraPaths: [${workspaceFolder}], python.testing.pytestArgs: [tests, -v, -s, --tbshort, --rootdir${workspaceFolder}] }--rootdir显式指定根目录能解决一部分 import 路径问题。4. 验证请求与成功结果从终端到测试树完整跑一遍配置写好了现在验证。先别急着点测试树打开终端手动跑一次cd /path/to/your/project source .venv/bin/activate # Windows 用 .venv\Scripts\activate python -m pytest tests -v -s如果这一步能看到用例列表和通过/失败结果说明 pytest 本身没问题问题在 VS Code 的发现或回传环节。如果这一步就报错先解决终端里的报错别管 VS Code。终端跑通后回到 VS Code点测试侧边栏的刷新按钮。正常情况下测试树会列出所有用例。点某个用例旁边的运行图标观察输出面板的Python Test Log。成功的话你会看到类似 test session starts platform darwin -- Python 3.11.4, pytest-7.4.0 collected 3 items tests/test_api.py::test_model_response PASSED tests/test_api.py::test_invalid_key FAILED tests/test_utils.py::test_parse PASSED 1 failed, 2 passed in 0.82s 测试树里对应的用例会变成绿色对勾或红色叉号。如果测试树不刷新但终端有结果多半是 VS Code 的测试适配器没收到回传试试重启 VS Code 窗口Developer: Reload Window。现在验证涉及模型调用的测试。写一个最小测试文件tests/test_taotoken.pyimport os import pytest import requests BASE_URL os.environ.get(TAOTOKEN_BASE_URL, https://taotoken.net/api) API_KEY os.environ.get(TAOTOKEN_API_KEY, ) def test_api_key_present(): assert API_KEY, TAOTOKEN_API_KEY 未设置 def test_model_call(): headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { model: gpt-4o-mini, messages: [{role: user, content: ping}], max_tokens: 5 } resp requests.post(f{BASE_URL}/v1/chat/completions, headersheaders, jsonpayload, timeout30) assert resp.status_code 200, f状态码 {resp.status_code}: {resp.text[:200]} data resp.json() assert choices in data assert len(data[choices]) 0在终端里设置环境变量再跑export TAOTOKEN_API_KEY你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api python -m pytest tests/test_taotoken.py -v -s如果两个用例都通过说明你的 Key、Base URL、请求格式、网络通道全部正常。这时候再回到 VS Code 测试树运行同一个文件如果 VS Code 里失败但终端通过那就是环境变量没传进 VS Code 的测试进程。解决办法是在settings.json里加{ python.testing.pytestArgs: [tests, -v, -s, --tbshort], python.testing.env: { TAOTOKEN_API_KEY: 你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api } }注意python.testing.env这个字段在部分 VS Code Python 扩展版本里支持如果你的版本不认改用.env文件加pytest-dotenv插件或者在测试文件顶部用os.environ.setdefault兜底。实测下来环境变量问题是「终端能跑、VS Code 不能跑」的最常见原因。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排查过程中你会撞到几个典型报错我按实际遇到的频率列一下对照着看。401 Unauthorized。这个最直接Key 不对或没传。检查三件事Key 有没有复制完整前后别带空格、请求头是不是Authorization: Bearer key格式、Base URL 是不是https://taotoken.net/api而不是别的。如果你在 VS Code 测试里遇到 401 但终端正常八成是python.testing.env没生效环境变量没传进去。可以在测试里加一行print(os.environ.get(TAOTOKEN_API_KEY, MISSING)[:8])确认。local proxy failed / connection refused。这个报错说明请求根本没发出去卡在本地网络层。先确认你没有在代码或环境变量里设置HTTP_PROXY/HTTPS_PROXY指向一个不存在的本地端口。检查方式env | grep -i proxy如果有输出临时清掉再跑unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy另外确认你的 Base URL 拼写正确别多斜杠或少斜杠。https://taotoken.net/api/v1/chat/completions是完整路径如果你在代码里把 Base URL 写成https://taotoken.net/api/然后又拼/v1/...可能变成双斜杠部分服务端会拒绝。reading choices / KeyError: choices。这个报错说明请求发出去了也返回了但返回体里没有choices字段。常见原因是模型名写错了服务端返回了一个错误对象而不是正常响应。打印完整返回体看print(resp.status_code) print(resp.text)如果返回的是{error: {message: model not found}}之类去模型对话页面确认可用模型名。另一个可能是你请求的路径不对比如漏了/v1。OAuth 相关报错。如果你在测试里用了某些需要 OAuth 的客户端库而库尝试走浏览器授权流程在无头测试环境里会卡住或报 OAuth 错误。排查方法是确认你用的是 API Key 方式而不是 OAuth 方式。TaoToken 的 API Key 走的是标准 Bearer 认证不需要 OAuth 流程。如果你在代码里引入了某个 SDK 默认走 OAuth查它的文档改成 API Key 模式。测试树空白但终端正常。除了前面说的环境变量问题还可能是测试文件命名不符合发现规则。pytest 默认发现test_*.py或*_test.pyunittest 默认发现test*.py。如果你的文件叫mytest.py可能不被发现。改文件名或在pytestArgs里加--python-files指定模式。测试跑完但结果不刷新。试试在settings.json里关掉autoTestDiscoverOnSaveEnabled改成手动刷新。有时候自动发现和手动运行冲突导致 UI 状态不一致。另外确认你的 VS Code Python 扩展是最新版旧版本在测试回传上有已知 bug。如果你在配置 CC Switch、Cline MCP 或 Codex 的auth.json记住三件套必须齐全Base URL 填https://taotoken.net/apiKey 填你创建的 API KeyModel ID 填你确认可用的模型名。缺任何一个都会导致请求失败而失败表现可能就是你看到的「测试没结果」。6. 把排查流程固化成习惯下次直接定位整套流程走下来你会发现「VS Code Python 测试不显示结果」从来不是单一原因。它可能是解释器选错、测试目录配错、环境变量没传、请求卡住、返回体解析失败中的任何一个。与其每次从头猜不如把验证顺序固定下来先终端手动跑 pytest确认框架层正常再用一个最小请求脚本确认 API 通道正常最后回到 VS Code 对比差异。TaoToken 在这个流程里的价值是给你一个可观测的请求入口。你可以在模型对话页面手动发消息确认账号状态用 API Keys 页面管理不同项目的 Key遇到请求格式问题翻接入文档。这些动作都不依赖 VS Code能帮你把「测试框架问题」和「网络链路问题」干净地分开。最后留一个实用技巧在你的测试目录下放一个conftest.py里面加一个 fixture 专门检查环境变量缺 Key 的时候直接 skip 而不是 fail这样测试树不会因为环境问题一片红import os import pytest pytest.fixture(autouseTrue) def check_env(): if not os.environ.get(TAOTOKEN_API_KEY): pytest.skip(TAOTOKEN_API_KEY 未设置跳过需要 API 的测试)这样你本地没配 Key 的时候相关用例显示为跳过而不是失败测试树状态更清晰。等你配好 Key它们会自动开始跑。