VSCode Python配置失败主因是环境变量、解释器路径与虚拟环境未对齐；须确保Windows安装时勾选Add Python to PATH，用where/python验证路径，再通过Python: Select Interpreter手动选择.venv解释器并设cwd和PYTHONPATH。
VSCode里Python配置失败，90%不是操作错，而是环境变量、解释器路径、虚拟环境三者没对齐——哪怕只差一步，import就报错，pip install装到系统目录，调试直接ModuleNotFoundError。
Python安装时PATH没勾选，VSCode根本找不到解释器
这是新手最常卡死的第一关：明明装了Python，VSCode左下角却显示“Select Python Interpreter”，点开列表空空如也。
- Windows安装器必须勾选
Add Python to PATH，否则python命令只在安装目录下有效，终端和VSCode都调不到 - 如果已安装但漏勾，别重装——手动把Python安装路径（比如
C:\Users\XXX\AppData\Local\Programs\Python\Python311\）和Scripts子目录加进系统环境变量PATH - 验证是否生效：打开新终端（不是旧窗口），运行
where python（Windows）或which python（macOS/Linux），看到路径才算成功 - VSCode重启后，按
Ctrl+Shift+P输入Python: Select Interpreter，就能刷出系统Python了
用venv创建虚拟环境，但VSCode没识别或激活失败
虚拟环境没被正确选中，是ModuleNotFoundError的头号来源。VSCode不会自动激活你创建的venv，它只认你手动指定的解释器路径。
- 先在项目根目录执行：
python -m venv .venv（推荐用.venv而非venv，VSCode默认识别点开头的目录） - 不要手动运行
activate脚本——VSCode不需要也不依赖shell激活状态，它只关心解释器路径 - 按
Ctrl+Shift+P→Python: Select Interpreter→ 在列表里找带.venv字样的路径，例如：./.venv/Scripts/python.exe（Win）或./.venv/bin/python（macOS/Linux） - 选中后，VSCode右下角会立刻显示该路径；此时再运行
pip install requests，包就装进.venv，不会污染全局
launch.json调试报错“找不到模块”，其实是工作区路径没设对
调试时提示ImportError，但终端里python xxx.py能跑通？大概率是launch.json里没指定正确的cwd（当前工作目录）。
立即学习“Python免费学习笔记（深入）”；
- VSCode调试默认以文件所在目录为工作路径，但如果项目结构是
src/main.py，而你的模块在src/utils.py，那main.py里的from utils import xxx就会失败 - 在
.vscode/launch.json的配置块里加这一行："cwd": "${workspaceFolder}/src"（按你实际源码目录调整） - 更稳妥的做法：在
.vscode/settings.json里加"python.defaultInterpreterPath": "./.venv/bin/python"（Linux/macOS）或对应Windows路径，确保所有功能统一指向同一环境 - 检查是否生效：在Python文件里写
import sys; print(sys.path)，看输出里有没有你的项目根目录——没有就说明cwd或PYTHONPATH没配对
插件装了但补全/跳转失效，Pylance没连上解释器
装完Python扩展，代码里函数名不提示、Ctrl+Click跳不到定义？不是插件坏了，是Pylance语言服务器没加载到正确的Python环境。
- Pylance依赖解释器提供的类型信息，如果
Python: Select Interpreter选的是系统Python，但你实际在.venv里开发，它就看不到你装的包 - 确认方式：打开一个
.py文件，看右下角是否显示Pylance并带绿色对勾；若显示“Starting”或报错，说明解释器路径有问题 - 临时解决：在设置里搜
python.analysis.extraPaths，添加你的src或lib目录，让Pylance知道去哪找模块 - 长期建议：关闭
python.analysis.autoSearchPaths（设为false），强制它只信任你明确指定的解释器和路径，避免混乱
真正卡住人的从来不是“怎么装”，而是“谁在用哪个解释器、在哪找模块、往哪装包”这三件事没闭环。每建一个新项目，务必重复三步：创建.venv → 用命令面板选中它 → 检查sys.path输出。少跳任何一环，后面所有报错都是它的影子。
