必须先正确选择Python解释器，否则VSCode所有功能均失效；需通过命令面板执行Python: Select Interpreter并指定准确路径，再创建虚拟环境、配置launch.json、安装black/flake8等工具至对应环境。
Python 解释器没选对，所有功能都白装
VSCode 本身不带 Python，装了官方 Python 扩展也默认不认你电脑里的 python。常见现象：写 import numpy 报错、右上角 ▶️ 按钮点不动、Ctrl+Space 没补全、断点灰掉——八成是解释器根本没选对。
- 先在终端确认路径：
where python（Windows）或which python3（macOS/Linux），记下输出，比如C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe或/opt/homebrew/bin/python3 - 在 VSCode 里按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入并执行Python: Select Interpreter - 如果列表里没有你的路径，就点
Enter interpreter path...，粘贴刚才复制的完整路径 - 选完看左下角状态栏是否显示该路径；再新建
test.py写import sys; print(sys.executable)，运行后输出必须和你选的一致
虚拟环境不是可选项，是隔离底线
不用虚拟环境，pip install 装的包会堆进全局 Python，不同项目依赖冲突时，ImportError 和 ModuleNotFoundError 就是常态。而且 VSCode 的 linting、格式化、调试全都依赖解释器环境，全局环境一乱，整个开发体验崩得无声无息。
- 在项目根目录打开终端，运行：
python -m venv venv（Win）或python3 -m venv venv（macOS/Linux） - 再执行一次
Python: Select Interpreter，这次它会自动扫到./venv/Scripts/python.exe（Win）或./venv/bin/python（macOS/Linux） - 选中后，终端左下角应显示
(venv)，且pip list输出应只有pip、setuptools、wheel—— 空或极简才对 - 别手动激活虚拟环境再开 VSCode：VSCode 通过解释器路径自动接管环境，手动激活反而容易错位
调试启动失败？大概率缺 launch.json
点 F5 报错 No configuration found for 'Python' 或直接无响应，不是插件坏了，是 VSCode 默认不生成调试配置文件。它只在你第一次显式进入调试视图时才引导创建，不是靠“选了解释器”就自动生成。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 按
Ctrl+Shift+D（Win/Linux）或Cmd+Shift+D（macOS）打开「运行和调试」侧边栏 - 点顶部的「创建 launch.json 文件」链接（不是命令面板里的选项）
- 选环境
Python File，VSCode 会在项目根目录下建.vscode/launch.json，内容默认就能跑当前文件 - 后续加断点、F5 启动、看变量监视器，全部可用；不需要改
launch.json除非你要传参数或改工作目录
格式化和 linting 不生效？先看 pip 装对地方了没
black 或 flake8 装在全局 Python 里，但 VSCode 正在用 ./venv/bin/python，那它们就根本找不到——结果就是「设置里开了 Format on Save，保存却没反应」。
立即学习“Python免费学习笔记（深入）”；
- 确保终端已切换到项目虚拟环境（左下角显示
(venv)） - 运行：
pip install black flake8（不是python -m pip install，避免装错解释器） - VSCode 会自动检测这些工具：装完后保存一个有空格或未用变量的文件，立刻看到波浪线或自动重排
- 如果还无效，检查设置里是否误关了：
python.formatting.provider应为black，python.linting.enabled应为true
最容易被忽略的是：VSCode 的「工作区设置」优先级高于用户设置，而虚拟环境路径是工作区级的。换个项目没重新选解释器，就可能沿用旧路径，导致 import 一切正常、但 pip 安装的包死活 import 不进来——因为 sys.executable 和 pip 不在同一个环境里。
