1. 为什么 Python3.6 在 VSCode 里点调试就卡住如果你手上还维护着 Python3.6 甚至 3.5 的老项目大概率遇到过这个画面代码里打好断点按下 F5VSCode 底部状态栏转两圈然后什么都没发生或者弹一句Debugger timeout、connect ECONNREFUSED 127.0.0.1:xxxxx。终端里脚本能正常跑唯独调试起不来。这不是你代码写错了而是 VSCode 的 Python 调试链路在近几年换过底层实现。早期用的是ptvsd后来迁移到debugpy而新版debugpy从某个版本开始把最低 Python 支持线抬到了 3.7。也就是说Python3.6 及以下版本用默认装上的调试器根本连不上调试适配器自然断点不生效。我试过在一台只能跑 Python3.6.8 的机器上折腾最后定位到三个关键点Python 扩展版本、Pylance 版本、以及launch.json里type字段到底写的是python还是debugpy。这三者任意一个不对调试会话就起不来。这篇就围绕这个场景把可复制的launch.json骨架、旧版本插件的处理方式以及怎么用 TaoToken 统一 Key 通道把调试环境里的模型调用也理顺一步步讲清楚。适合还在维护老 Python 项目、又想在 VSCode 里正常打断点的同学。2. 先把调试链路和 TaoToken 通道理清楚在动手改配置之前得先明白两件事一是 VSCode 调试 Python 到底靠什么二是为什么这里会牵扯到 TaoToken。VSCode 本身不懂 Python它通过「调试适配器协议」跟一个调试器进程通信。Python 扩展负责启动这个进程launch.json里的type字段决定用哪个适配器。写python时扩展会走它内置的调试逻辑写debugpy时会去调用独立的 Debugpy 扩展。对 Python3.6 来说只有走python这条老路径才稳。那 TaoToken 在这里的角色是什么很多老项目在调试时会顺带调用大模型接口做日志分析、代码补全或者单元测试生成。如果每个脚本里都硬编码一份 Key换环境就得改一堆文件。TaoToken 提供的是统一的 Key 和 API 通道你只需要在环境变量或配置文件里维护一份调试会话启动时自动读取省得来回改。它的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址不带后面那串参数配置时别抄错。提示TaoToken 是统一 Key 通道不是让你替换编辑器。调试逻辑还是 VSCode 自己的它只负责把模型调用的鉴权和路由收口到一处。3. 可复制的 launch.json 配置骨架这一步是核心。先在项目根目录建.vscode文件夹里面放launch.json。如果已经有直接改configurations数组。{ version: 0.2.0, configurations: [ { name: Python: 当前文件 (3.6兼容), type: python, request: launch, program: ${file}, console: integratedTerminal, justMyCode: false, env: { PYTHONUNBUFFERED: 1, TAOTOKEN_API_BASE: https://taotoken.net/api, TAOTOKEN_API_KEY: ${env:TAOTOKEN_API_KEY} }, python: ${command:python.interpreterPath} } ] }几个字段逐个说。type必须是python这是走原生调试路径的关键写成debugpy或debugpy-old在 3.6 上大概率失败。console用integratedTerminal而不是internalConsole因为老版本 Python 在内部控制台里经常拿不到标准输入断点命中后变量面板也可能是空的。justMyCode设成false这样能跟进标准库和第三方库排查老项目里那些藏在依赖里的问题时很有用。env里塞了 TaoToken 的基址和 KeyKey 用${env:TAOTOKEN_API_KEY}从系统环境变量读不写死在文件里避免提交到仓库。如果你项目里用的是虚拟环境把python那行换成具体解释器路径更稳python: ${workspaceFolder}/venv/bin/pythonWindows 下则是${workspaceFolder}\\venv\\Scripts\\python.exe。这一步别偷懒老机器上经常有多个 Python 版本指错了就调到别的解释器上去了。4. 旧版本插件与 debugpy 的处理光改launch.json还不够插件版本得配套。Python 扩展建议锁到2022.8.1Pylance 锁到2022.6.30。这两个版本对 Python3.6 的支持是完整的再往后的版本会逐步放弃老解释器。在 VSCode 扩展面板搜 Python点齿轮图标选「安装特定版本」输入2022.8.1。Pylance 同理装2022.6.30。装完记得在扩展设置里关掉自动更新否则某天它悄悄升级调试又挂了。然后是Python Debugger和Debugpy Old这两个扩展。如果你装过建议直接卸载。原因很简单它们会把launch.json的type引导成debugpy而新版 debugpy 不支持 3.6。卸载后创建配置时就不会被带偏。组件推荐版本作用Python 扩展2022.8.1提供调试适配与解释器管理Pylance2022.6.30语言服务兼容 3.6Python Debugger卸载会引导 typedebugpy导致失败Debugpy Old卸载同上老项目不需要注意卸载这两个扩展不影响你调试因为type: python走的是 Python 扩展自带的调试逻辑不依赖它们。5. 验证调试会话是否正常启动配置改完怎么确认真的生效了别急着上复杂项目先写个最小脚本。# debug_test.py import os import sys def main(): print(Python 版本:, sys.version) api_base os.environ.get(TAOTOKEN_API_BASE, 未设置) print(TaoToken API 基址:, api_base) total 0 for i in range(5): total i # 在这行打断点 print(累加中:, total) print(最终结果:, total) if __name__ __main__: main()在total i那行左侧点一下打红点按 F5 选「Python: 当前文件 (3.6兼容)」。正常的话终端会打印 Python 版本然后停在断点处左侧变量面板能看到i、total的值按 F10 单步、F5 继续。如果断点变成空心灰圈说明调试器没挂上回到第 3 步检查type字段。如果终端里TaoToken API 基址打印的是「未设置」说明环境变量没读到检查系统里有没有导出TAOTOKEN_API_KEY和TAOTOKEN_API_BASE。想进一步确认 Key 通道通不通可以在调试会话里临时加一段请求import os import urllib.request import json def check_taotoken(): base os.environ.get(TAOTOKEN_API_BASE, https://taotoken.net/api) key os.environ.get(TAOTOKEN_API_KEY, ) if not key: print(Key 未配置跳过检查) return req urllib.request.Request( base /models, headers{Authorization: Bearer key} ) try: with urllib.request.urlopen(req, timeout10) as resp: data json.loads(resp.read().decode()) print(通道正常模型数量:, len(data.get(data, []))) except Exception as e: print(通道检查失败:, e) check_taotoken()这段在断点命中后于调试控制台里手动调用check_taotoken()就能看到结果。能打印出模型数量说明 Key 和基址都对。6. 本篇常见错排查调试起不来报错五花八门这里列几个高频的。报错Debugger timeout或一直转圈九成是type写成了debugpy。改成python并确认 Python Debugger 扩展已卸载。断点变灰提示「未绑定断点」解释器路径不对VSCode 用的不是你预期的 Python3.6。在launch.json里显式写python字段指向具体路径或者用命令面板「Python: 选择解释器」切过去。终端里中文乱码老版本 Python 在 Windows 终端默认编码是 GBK。在env里加PYTHONIOENCODING: utf-8即可。TaoToken 请求返回 401Key 没读到或者格式不对。确认环境变量名是TAOTOKEN_API_KEY值里没有多余空格。基址用 https://taotoken.net/api 别拼成带 UTM 的官网地址。调试会话能起但变量面板空白console用了internalConsole。改成integratedTerminal重启调试。装完旧版插件后 VSCode 提示不兼容忽略即可2022.8.1 和 2022.6.30 在较新 VSCode 上会提示但功能正常。实在介意就降 VSCode 版本不过没必要。排障过程中如果反复卡在 Key 配置上可以直接去控制台生成和管理 Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 生成后复制到环境变量里。接入细节和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的参数表。7. 把 Key 通道收口到一处老项目调试最烦的就是环境切换。开发机、测试机、同事机器上 Key 各不一样每次拉代码都要改配置。用 TaoToken 统一通道后launch.json里只留环境变量引用真实 Key 放在系统环境或.env文件里代码和配置都不用动。如果你调试时经常需要跟模型对话来辅助定位问题可以直接用模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 把报错日志贴进去问比在本地反复试快。长期在 VSCode 里做编码和 Agent 类任务的话Coding Plan 更合适入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它把常用模型的调用额度打包省得每次单独配。Key 的生成和轮换在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 建议给调试环境单独建一个 Key权限收窄万一泄露也好吊销。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不认识的先翻这里。最后补一句实操经验改完launch.json后别只按 F5先用命令面板跑一次「Debug: Restart」确保旧会话彻底清掉。老版本 Python 的调试进程有时候会残留不重启会一直连到旧的适配器上表现就是配置明明改了却还是老报错。