VSCode搜不到Python插件时，应先确认网络与市场状态：等待加载完成、关闭代理/防火墙、确保autoCheckUpdates和autoUpdate为true，或手动访问marketplace安装；务必认准官方ms-python.python插件（Microsoft发布、6000万+安装量），装完后需手动选择已安装的Python解释器路径方可启用全部功能。
VSCode 里搜不到 Python 插件？先确认网络和插件市场状态
不是所有 VSCode 安装后都能立刻搜到 Python 插件，常见原因是插件市场未加载完成、代理设置干扰，或本地 DNS 解析异常。打开 VSCode 后，先等几秒再点左侧扩展图标（或按 Ctrl+Shift+X），如果搜索框下方显示 “Loading…” 超过 10 秒，就别硬等。
可尝试以下操作：
- 关闭 VSCode，重启一次（不是重开窗口，是彻底退出进程）
- 检查系统是否启用了全局代理或企业防火墙——临时关闭后重试
- 在 VSCode 设置中搜索
extensions.autoCheckUpdates，确保为true；再搜extensions.autoUpdate，也设为true - 如果仍失败，手动访问 https://www.php.cn/link/3d29fb5278af9da98e9e7c9d3c97b9e2，点击“Install” 会自动唤起已登录的 VSCode 并开始安装
安装时选错插件？认准官方出品的 ms-python.python
搜索 “Python” 会出现十几个结果，但只有微软官方维护的那个才带完整调试、语言服务、Jupyter 支持。它图标是蓝白蛇形，作者显示 Microsoft，ID 是 ms-python.python。其他同名插件比如 python-extension 或 vscode-python 都是旧版、弃用或第三方维护，功能不全且可能报错。
安装前建议确认：
立即学习“Python免费学习笔记（深入）”；
- 插件页面右上角显示 “Verified publisher: Microsoft”
- 安装量 > 6000 万（截至 2026 年中）
- 更新日期在近 3 个月内（避免用停更两年的老版本）
- 不要同时装
Code Runner+Python插件来跑脚本——它们的执行逻辑冲突，code-runner.executorMap里的python命令容易覆盖python.defaultInterpreterPath
装完插件没反应？检查 Python 解释器是否被识别
插件装完只是第一步，它需要一个可用的 python.exe 才能工作。如果你没装过 Python，或者装的时候没勾选 Add Python to PATH，VSCode 就找不到解释器，底部状态栏会一直显示 “Select Python Interpreter”，点进去是空列表。
这时要做的不是重装插件，而是：
- 先去官网下载并安装 Python（推荐
3.9.10或3.12.x），安装时**必须勾选**Add Python to PATH - 打开命令提示符，运行
python --version和where python，确认能输出版本号和路径（如C:\Users\XXX\AppData\Local\Programs\Python\Python312\python.exe） - 回到 VSCode，按
Ctrl+Shift+P，输入Python: Select Interpreter回车，在弹出列表里选那个真实路径，而不是 “Enter interpreter path…” 手动填 - 如果列表里压根没内容，说明 VSCode 没扫描到系统 PATH 里的 Python——此时可关掉 VSCode，用管理员权限重新启动一次
装完插件但调试失败？注意 launch.json 的生成时机
Python 插件本身不自动生成 .vscode/launch.json，这个文件只在你首次点击右上角 ▶️ 运行按钮、或按 F5 启动调试时，由插件引导创建。很多人误以为装完插件就该有配置，其实没有。
真正需要关注的是：
- 新建一个
.py文件（比如hello.py），写一行print("ok")，保存 - 确保当前文件是编辑器焦点（不是空白标签页），再点 ▶️ 或按
F5 - 第一次会弹出环境选择 → 选你刚配好的解释器 → 然后才生成
launch.json - 如果弹窗卡住或报错
No debug adapter found，大概率是解释器路径含中文、空格或符号（比如C:\我的项目\），换到纯英文路径下重试
插件安装本身很简单，难的是让整个链路连通：系统能找到 python.exe，VSCode 能读到它，解释器又能加载标准库和 pip 包。任一环节断开，都会表现为“插件装了但没用”。
