VS Code中‘Run Code’无法识别已安装包问题求助（Mac OS）

1. Code Runner插件未使用选中的虚拟环境解释器 #

VS Code的「Run Code」按钮来自Code Runner插件，它的运行机制独立于VS Code自带的Python解释器配置，默认可能调用系统全局Python，而非你选中的虚拟环境。

• 解决方式：
  • 打开VS Code设置，搜索code-runner.executorMap，修改Python对应的执行路径为虚拟环境的Python路径，比如~/miniconda3/envs/你的环境名/bin/python。
  • 或者开启code-runner.runInTerminal选项，让插件在终端中运行代码，自动复用终端的虚拟环境配置。

2. 虚拟环境的环境变量未被Code Runner加载 #

Mac下若终端使用zsh，VS Code的Code Runner可能未加载~/.zshrc中的conda配置，导致运行时无法识别虚拟环境的模块路径，但手动在终端激活环境时能正常读取。

• 解决方式：
  • 检查VS Code的terminal.integrated.profiles.osx配置，确保zsh的启动命令包含加载~/.zshrc的逻辑；
  • 或在VS Code设置中添加terminal.integrated.env.osx，将虚拟环境的PATH（如~/miniconda3/envs/你的环境名/bin）加入环境变量列表。

3. pip安装的模块路径异常 #

在虚拟环境中使用pip时，若存在权限或pip配置问题，模块可能被安装到全局Python路径而非虚拟环境内。手动运行时因终端激活了环境能找到模块，但Code Runner的环境未正确读取路径。

• 解决方式：
  • 在虚拟环境中执行pip show <报错的模块名>，查看Location字段是否指向虚拟环境的lib/pythonX.X/site-packages目录；
  • 若路径错误，使用虚拟环境的pip重新安装：~/miniconda3/envs/你的环境名/bin/pip install <模块名>。

4. VS Code Python扩展缓存未更新 #

VS Code的Python扩展可能缓存了旧的解释器信息，导致Run Code时未使用新选中的虚拟环境。

• 解决方式：重启VS Code，或按Cmd+Shift+P打开命令面板，重新执行Python: Select Interpreter选择目标虚拟环境。

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