Cursor.ai无法识别Mac Sonoma下全部Python解释器/虚拟环境求助

排查与修复步骤 #

• 手动添加未识别的虚拟环境
  打开Cursor的设置面板，找到「Python解释器」配置项，点击「添加解释器」，手动选择目标虚拟环境目录下的bin/python文件（例如~/projects/my-app/venv/bin/python），保存后Cursor会自动加载该环境的依赖包与配置。

• 确保Cursor继承终端环境变量
  如果你的虚拟环境是通过pyenv、conda或poetry等工具创建的，这些工具的路径可能未被Cursor默认加载：

  1. 关闭Cursor；
  2. 在终端中运行cursor命令启动Cursor，而非通过Launchpad或Dock启动，这样Cursor会继承终端的完整环境变量，包括虚拟环境管理工具的路径。

• 清除Cursor的Python解释器缓存
  Cursor会缓存已扫描到的解释器，清除缓存可强制重新扫描系统内所有环境：

  1. 完全关闭Cursor；
  2. 删除目录：~/Library/Application Support/Cursor/User/globalStorage/ms-python.python；
  3. 重新启动Cursor，等待系统扫描完成后检查解释器列表。

• 验证虚拟环境完整性
  对未被识别的虚拟环境，在终端中进入环境目录，执行./bin/python --version确认环境可正常运行。若命令报错，说明虚拟环境已损坏，需重新创建（例如python3 -m venv new-venv）后再尝试。

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