VSCode选中的解释器与终端实际运行环境不一致，根本原因是终端作为独立shell进程，其PATH未同步编辑器所选解释器路径；需验证sys.executable路径、启用python.terminal.activateEnvironment、清理残留配置并重启终端。
VSCode 选中的解释器和终端实际运行的不是同一个
这是最常见也最容易被忽略的错配。你点开底部状态栏选了 .venv/bin/python，但新开的集成终端里跑的仍是 /usr/bin/python3——Pylance 和调试器按解释器路径查包，而终端按 PATH 找 Python，两者根本不在一个环境里。
验证方法很简单：在 VSCode 内置终端中执行
python -c "import sys; print(sys.executable)"
再按 Ctrl+Shift+P 输入 Python: Select Interpreter，对比输出路径是否完全一致。不一致就手动选中终端里显示的那个路径；如果列表里没有，点 Enter interpreter path... 粘贴进去。
改完必须关闭所有已打开的终端再新建一个，否则旧进程还带着错误的 PATH 缓存。
立即学习“Python免费学习笔记（深入）”；
虚拟环境没被终端自动激活，python.terminal.activateEnvironment 没开
即使解释器选对了，终端默认也不会自动 source 或 activate 虚拟环境——它只认你当前 shell 的配置，不继承 VSCode 的解释器设置。
解决方式是显式启用自动激活：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 打开工作区的
.vscode/settings.json - 添加：
"python.terminal.activateEnvironment": true - 保存后关闭并重开所有终端
注意：这个设置只影响新打开的终端，不影响已运行的进程；也不影响调试器（调试器走的是解释器路径，不走 shell 激活逻辑）。
PYTHONPATH 没配，跨文件夹 import 就报 ModuleNotFoundError
比如项目结构是 src/utils.py，你在 main.py 里写 from src.utils import helper，却提示找不到 src——这不是包没装，是 Pylance 和运行时都看不到 src 所在目录。
正确做法不是改 sys.path，而是通过环境变量告诉 Python 去哪找：
- Linux/macOS：在
.vscode/settings.json中加
"terminal.integrated.env.linux": {
"PYTHONPATH": "${workspaceFolder}${pathSeparator}${env:PYTHONPATH}"
}
- Windows：用
terminal.integrated.env.windows替换上面的 key - 改完保存，关掉所有终端再重开
别用 python.terminal.executeInFileDir 或 code-runner.fileDirectoryAsCwd，它们只改工作目录，不改模块搜索路径。
残留配置污染导致路径硬编码失效
你删了 .venv，但 .vscode/settings.json 里还留着 "python.defaultInterpreterPath": "/old/path/to/.venv/bin/python"，或者用户级设置里全局锁死了某个已不存在的解释器——VSCode 会静默 fallback 到系统 Python，然后一切导入都失败。
清理步骤要彻底：
- 删掉项目下的
.vscode/settings.json - 删掉
.vscode/workspaceStorage/整个文件夹 - 进 VSCode 全局设置（
Ctrl+,），搜python default interpreter，清空python.defaultInterpreterPath字段
做完这些再重新选解释器、重装包，路径才真正干净。很多人卡在“重装了十次 pandas 还是标红”，其实只是 VSCode 一直在读一个指向废路径的配置。
