VSCode虚拟环境中安装Python包失败（提示依赖已满足）

问题现象 #

激活虚拟环境并在VSCode中选定对应解释器后，执行pip install {PACKAGE NAME}时出现以下提示，包未安装到虚拟环境文件夹：

Defaulting to user installation because normal site-packages is not writeable
Requirement already satisfied: {PACKAGE NAME} in c:\users\lavaa\appdata\roaming\python\python311\site-packages

明明处于虚拟环境，pip却读取用户目录下的Python包，且无法将目标包安装到虚拟环境的site-packages目录。

原因分析 #

• 虚拟环境的site-packages目录无写入权限，导致pip自动回退到用户级安装目录
• VSCode未正确绑定虚拟环境的pip，实际调用的是全局或用户级pip
• 虚拟环境激活不彻底，环境变量未完全覆盖全局设置

解决步骤 #

1. 确认虚拟环境激活状态
   检查VSCode终端提示符前是否带有虚拟环境名称（如(venv)），若未激活，手动执行：

   # Windows 命令行
   venv\Scripts\activate.bat
   # Windows PowerShell
   venv\Scripts\Activate.ps1
   

2. 验证pip归属
   执行命令确认pip路径属于当前虚拟环境：

   # Windows
   where pip
   # Linux/macOS
   which pip
   

   输出需指向虚拟环境目录下的Scripts\pip.exe（Windows）或bin/pip（类Unix系统），否则说明解释器配置错误。

3. 修复虚拟环境目录权限

   • 右键虚拟环境文件夹，进入「属性」>「安全」，确保当前用户拥有「写入」权限
   • 或直接以管理员身份启动VSCode，再激活虚拟环境执行安装

4. 强制指定安装路径
   使用--target参数直接指定虚拟环境的site-packages目录：

   pip install {PACKAGE NAME} --target .\venv\Lib\site-packages
   

5. 重新配置VSCode解释器

   • 按Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter
   • 选择虚拟环境目录下的python.exe（如./venv/Scripts/python.exe），重启VSCode后重试安装

内容的提问来源于stack exchange，提问作者Lavaa