VS Code虚拟环境Python包安装异常：仅全局解释器生效

问题原因 #

你遇到的核心问题是终端没激活虚拟环境，导致执行py -m pip install matplotlib时调用了全局Python的pip，包自然装到了全局环境里。

虽然你在VS Code里通过「Python: Select Interpreter」选了虚拟环境，但这个操作只是让编辑器/调试器用虚拟环境的解释器，并不会自动激活终端里的环境。终端如果没激活虚拟环境，所有pip、Python命令默认还是走全局版本。

解决步骤 #

1. 手动激活虚拟环境 #

打开VS Code的终端，根据你的系统执行对应命令：

• Windows（PowerShell）：进入虚拟环境文件夹的Scripts子目录，执行

  .\activate
  

• Windows（CMD）：同样进入Scripts目录，执行

  activate.bat
  

• macOS/Linux：进入虚拟环境文件夹的bin子目录，执行

  source activate
  

激活成功后，终端开头会显示虚拟环境的名称（比如(venv)）。

2. 在激活的环境中安装包 #

激活后直接执行：

pip install matplotlib

这时pip就是虚拟环境内的版本，包会被安装到虚拟环境的Lib\site-packages（Windows）或lib/pythonX.X/site-packages（macOS/Linux）目录下。

3. 让VS Code终端自动激活虚拟环境 #

打开VS Code的设置（快捷键Ctrl+,），搜索「Python: Terminal Activate Environment」，勾选这个选项。以后每次打开终端，VS Code会自动激活你当前选中的虚拟环境，不用手动执行激活命令。

验证方法 #

安装完成后，可以通过两种方式确认：

• 在终端执行pip list，查看输出里是否有matplotlib；
• 在Python脚本中添加：

  import sys
  print(sys.executable)
  

  运行脚本，输出的路径应该是虚拟环境文件夹里的Python可执行文件（比如venv\Scripts\python.exe），说明调试器确实用了虚拟环境的解释器，且包已正确安装。

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