必须手动配置Python解释器路径，否则无法运行代码；需通过命令面板选择已安装版本或手动输入路径，并确保右下角状态栏显示正确解释器，尤其注意虚拟环境、conda、poetry等场景下解释器与pip环境的一致性。
找不到 Python 解释器：VSCode 提示 Python interpreter not found
VSCode 本身不自带 Python，必须手动指定解释器路径。没配好就根本没法运行代码，连 print() 都会报错。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter回车 - 从列表选已安装的 Python 版本（如
Python 3.11.9 ('base': conda)或/usr/bin/python3）；如果没出现，点Enter interpreter path...手动填，常见路径：/usr/bin/python3（macOS/Linux）、C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe（Windows） - 确认当前文件是
.py后缀，且右下角状态栏显示了正确的解释器——否则配置无效 - 虚拟环境激活后，必须在 VSCode 内重新选一次解释器，不能只靠终端里
source venv/bin/activate
运行时提示 ModuleNotFoundError: No module named 'xxx'
不是包没装，而是 VSCode 用的解释器和你 pip install 的环境不一致。尤其在用 conda、venv、poetry 时特别容易踩坑。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先在终端里运行
which python（macOS/Linux）或where python（Windows），再运行python -m pip list | grep xxx确认包是否真在该环境里 - VSCode 的集成终端（
Ctrl+`）默认复用当前解释器环境，但「运行 Python 文件」按钮（▶️）走的是独立路径，必须确保解释器选对 - 如果用了
poetry，别直接选poetry env info --path返回的路径，要选里面bin/python（macOS/Linux）或Scripts\python.exe（Windows） -
pip install时加了--user？那包装在用户级目录，得选系统 Python 解释器，而不是虚拟环境里的
点击 ▶️ 运行却没反应，或终端一闪而过
这是 VSCode 默认用 python -u 方式执行，但某些脚本（尤其是带 input() 或图形界面的）需要交互式终端保持打开。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 右键文件 →
Run Python File in Terminal，比顶部 ▶️ 按钮更可靠 - 检查设置里
python.terminal.executeInFileDir是否为true，否则可能在错误路径下运行，导致读不到本地数据文件 - 如果脚本末尾没暂停，加一句
input("Press Enter to exit...")临时观察输出 - 终端编码问题也可能导致卡住，比如 Windows 上中文路径 + 默认
gbk编码，可在设置里把python.defaultInterpreterPath对应的解释器启动参数加-X utf8
launch.json 配置错误导致调试失败
调试（F5）和直接运行是两套逻辑。改了 launch.json 却没生效，大概率是没选对配置项，或路径写死。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 首次调试时 VSCode 会自动生成
.vscode/launch.json，但默认是"module": "runpy"，如果想调试带命令行参数的脚本，改成"module": "my_script"并删掉"args"外层的["--arg"]包裹 -
"cwd"必须设为工作目录，否则相对路径全错；推荐用"${fileDirname}"动态取当前文件夹 - 调试 Flask/FastAPI 时，别用
"module": "flask"，而要用"module": "flask.cli"，并确保"args"是["run", "--no-debug", "--port=5000"] - 修改
launch.json后必须重启调试会话，热重载不生效
最常被忽略的是解释器和终端环境的“双轨制”：你在一个地方装了包，在另一个地方运行，还觉得是 VSCode 的 bug。多看右下角那个小字——它才是真相。
