Pylance仅识别VSCode当前激活的Python解释器及其site-packages。需通过“Python: Select Interpreter”选择含目标库的环境，确保右下角路径与pip list一致，并检查pyenv/conda配置、extraPaths设置、导入名与包名差异及缓存是否更新。
确认Pylance是否在用正确的Python环境
Pylance不会自动继承终端或系统PATH里的Python，它只认VSCode当前激活的解释器。如果你用pip install requests装了库，但VSCode右下角显示的是/usr/bin/python3或某个conda env之外的路径，那Pylance根本看不到那些包。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，选一个明确包含你目标库的环境（比如~/venv/bin/python或./.venv/Scripts/python.exe） - 检查VSCode右下角状态栏——必须看到带路径的Python版本号，且路径要和你运行
pip list时用的Python一致 - 如果用了pyenv、asdf这类版本管理器，确保
PYTHONPATH没被意外覆盖，且VSCode是通过shell命令启动的（比如从终端执行code .）
检查Pylance是否禁用了“导入解析”或启用了严格模式
Pylance默认会扫描已知site-packages，但如果配置里关了python.analysis.extraPaths或开了python.analysis.typeCheckingMode为basic以外的值，可能跳过第三方模块类型推导。
实操建议：
- 打开VSCode设置（
Ctrl+,），搜索python.analysis.extraPaths，留空即可；填了反而容易干扰 - 确认没有手动设
python.analysis.autoSearchPaths为false（默认是true） - 避免在
settings.json里加"python.analysis.typeCheckingMode": "off"或"strict"——前者让Pylance不报错但也不补全，后者对未标注类型库（如requests、pandas）极易误报Import "xxx" could not be resolved
PyPI包名和导入名不一致导致Pylance找不到
很多包安装名和import名不同：比如pip install python-dotenv，但代码里写import dotenv；又如pip install Pillow，但from PIL import Image。Pylance靠的是import语句里的名字，不是包名。
实操建议：
- 查包的真实导入名，最稳的方式是进Python交互环境执行：
import pkgutil; [name for _, name, _ in pkgutil.iter_modules() if 'dotenv' in name] - 常见陷阱：
beautifulsoup4→bs4，python-dateutil→dateutil，scikit-learn→sklearn - 如果Pylance仍标红，临时加一行注释
# type: ignore不是解决办法，先确认是不是导入名写错了
缓存损坏或Pylance索引没更新
Pylance会缓存已解析的模块结构。换环境、重装包、或升级Pylance后，旧缓存可能残留错误信息，导致明明装了却报Import "xxx" could not be resolved。
实操建议：
- 重启Pylance：按
Ctrl+Shift+P，运行Developer: Reload Window（不是关窗口再开） - 清空Pylance缓存：关闭VSCode，删掉
~/.vscode/extensions/ms-python.vscode-pylance-*/out/下的cache目录（Windows路径类似%USERPROFILE%\.vscode\extensions\ms-python.vscode-pylance-*/out/cache） - 观察Pylance状态栏图标——如果是灰色齿轮，说明正在索引；等它变成蓝色对勾再看提示是否消失
最容易被忽略的一点：Pylance识别第三方库依赖于Python解释器自身的sys.path，而不是VSCode的workspace设置。哪怕你在项目根目录放了pyproject.toml或requirements.txt，它也不会自动去读——必须让解释器真正加载到那个环境，Pylance才看得见。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
