VSCode中pip install不生效的根本原因是解释器环境错配；需通过右下角确认Python解释器路径、在内置终端验证python/pip路径一致，并用python -m pip install确保安装到目标环境。
在VSCode里直接运行pip install为什么经常不生效
因为VSCode默认可能没用对Python解释器环境——你终端里pip install requests成功了，但VSCode的Python插件却还在用系统Python或另一个虚拟环境，导致import requests报ModuleNotFoundError。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，选中项目根目录下.venv或venv里的python可执行文件（路径含venv/bin/python或venvScriptspython.exe） - 确认右下角状态栏显示的解释器路径和你期望的一致；不一致时，所有终端、调试、代码补全都可能错配
- 打开集成终端（
Ctrl+`）后，先执行which python（macOS/Linux）或where python（Windows），确保它指向你刚选的那个环境
怎么从当前VSCode环境生成准确的requirements.txt
别用 pip freeze > requirements.txt——它会把所有包（包括pip、setuptools、wheel甚至VSCode插件依赖）全 dump 出来，污染生产环境。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 优先用
pipreqs：先pip install pipreqs，再在项目根目录运行pipreqs . --force，它只扫描import语句，生成最小依赖集 - 如果项目有
setup.py或pyproject.toml，用pip-tools更稳妥：pip install pip-tools，写好requirements.in（只写顶层依赖），再运行pip-compile requirements.in - 生成后务必检查：
requests==2.31.0这类带版本号的是锁定版，适合部署；若留requests不带版本，CI/CD 构建时可能拉到不兼容新版
VSCode里点“运行”却提示ModuleNotFoundError，但终端能跑
这是最典型的环境错位：VSCode调试器用的不是你当前终端激活的环境，而是它自己缓存的解释器配置，且调试启动时不会自动 source venv/bin/activate。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 检查项目根目录是否有
.vscode/settings.json，确认里面有类似："python.defaultInterpreterPath": "./venv/bin/python"
（macOS/Linux）或"python.defaultInterpreterPath": ".\venv\Scripts\python.exe"
（Windows） - 调试前，在
.vscode/launch.json中显式指定python路径："configurations": [{ "name": "Python: Current File", "type": "python", "request": "launch", "module": "your_module", "console": "integratedTerminal", "python": "./venv/bin/python" }] - 禁用“自动激活虚拟环境”干扰：在 VSCode 设置里搜
python.terminal.activateEnvironment，设为false，避免终端自动激活反而覆盖你手动选的解释器
用pip install -e .开发安装后，VSCode仍找不到模块
-e 安装本质是添加一个 .pth 文件或软链到 site-packages，但 VSCode 的语言服务器（Pylance）默认不扫描这些路径，所以 import 补全失败、跳转失效。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在项目根目录加
pyrightconfig.json（或pyproject.toml中配[tool.pyright]），加入：{ "extraPaths": ["src", "lib"] }（根据你实际源码目录调整） - 或者更直接：在
.vscode/settings.json加"python.defaultInterpreterPath": "./venv/bin/python", "python.analysis.extraPaths": ["src"]
- 改完配置后，必须重启 Pylance：按
Ctrl+Shift+P→ 输入Python: Restart Language Server，否则不生效
.vscode/settings.json 里有没有硬编码的 python.defaultInterpreterPath，最后检查 python.analysis.extraPaths 是否漏配——这三处对齐了，90% 的依赖问题就消失了。 
