ModuleNotFoundError主因是解释器、终端、调试器三者环境不一致；需确保右下角解释器路径与终端中python -c "import sys; print(sys.executable)"输出逐字符一致，且装库必须用python -m pip install，调试需在launch.json中显式指定python路径。
VSCode里import报ModuleNotFoundError，90%不是库没装，而是你根本没在“对的环境”里装——解释器路径、终端激活、调试器配置三者不一致，就会各走各的路。
conda env list能看见，但Python: Select Interpreter里没有
这不是VSCode漏扫，是它压根没加载conda初始化脚本。终端里跑conda env list失败，说明conda.sh（Linux/macOS）或conda.ps1（Windows）没被读取。
- 先确认conda路径：
which conda（macOS/Linux）或where conda（Windows） - 在VSCode内置终端里手动加载：
source ~/miniconda3/etc/profile.d/conda.sh（Linux/macOS）或call %USERPROFILE%Miniconda3Scriptsctivate.bat（Windows） - 永久生效：必须从终端启动VSCode（
code .），别双击图标——后者不继承shell环境变量 - 如果用
mamba创建的环境，VSCode识别率低，优先用conda create -n myenv python=3.11重建
右下角显示了myenv，但终端里python -c "import sys; print(sys.executable)"输出不对
状态栏显示只是缓存值，实际运行时可能还在用系统Python。终端是否自动激活当前环境，取决于python.terminal.activateEnvironment设置。
- 打开设置，搜
python.terminal.activateEnvironment，确保勾选 - 重启VSCode终端（Ctrl+Shift+` → 右上角垃圾桶图标），再执行
python -c "import sys; print(sys.executable)" - 输出必须和右下角路径**逐字符一致**；若显示
/usr/bin/python3，说明终端根本没切过去 - 禁用
python.defaultInterpreterPath手动硬编码路径——它会绕过环境发现机制，导致Pylance无法索引包
pip install装了，但import还是报错
裸敲pip install极大概率调用了base环境或系统pip，和当前解释器完全无关。唯一可靠方式是让pip明确绑定到当前python可执行文件。
立即学习“Python免费学习笔记（深入）”；
- 在已确认解释器正确的VSCode终端中，只用
python -m pip install requests，别用pip install - 装完后立刻验证：
python -m pip list | grep requests（Linux/macOS）或python -m pip list | findstr requests（Windows） - 批量安装：
python -m pip install -r requirements.txt，国内加清华源：python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ numpy - 如果环境里没
pip（新conda环境常见），先conda activate myenv && conda install pip
调试器（F5）报错找不到模块，但终端里python script.py能跑
VSCode调试器默认不继承终端激活状态，它会按launch.json或fallback规则找Python，常掉进系统Python坑里。
- 必须在
.vscode/launch.json中显式指定"python"字段，值为当前conda环境的绝对路径，例如："python": "/home/user/miniconda3/envs/myenv/bin/python"（Linux/macOS）或"python": "C:\Users\user\Miniconda3\envs\myenv\python.exe"（Windows） - 删掉
"console": "externalTerminal"，改用"console": "integratedTerminal"，避免新开黑窗丢失环境 - 不要依赖绿色三角按钮首次运行——它背后可能触发
conda run -n myenv python script.py，而该命令不会加载用户profile，容易缺PATH
最易被忽略的一点：conda环境路径里含空格或中文，VSCode解析会失败；哪怕路径合法，也要确认python.exe（Windows）或python（Linux/macOS）文件真实存在，不能只选到envs/myenv/目录层级。
