终极 Debug 纪实:AI 与极客联手击破 Cursor Python 解释器卡死谜案
背景设定
- 原始环境:Intel 架构 Mac,pyenv 管理多 Python 版本,环境优雅。
- 迁移:macOS 系统迁移工具一键搬家到 Apple Silicon (M4) 新机,所有配置、隐藏目录、工具链一锅端。
- 新问题:Cursor(AI code editor,VS Code 衍生)Python 插件死活卡在“Discovering Python Interpreters”,开发体验极差。
1. 初步尝试:极客的直觉
- 直接用 uv 创建虚拟环境
.venv
,命令行下激活、pip、python 一切正常。 - 但 Cursor GUI 里 Python 插件一直在“Discovering Python Interpreters”,无法流畅选择虚拟环境。
- 卸载 Python 插件后问题消失,重装后复现,直觉告诉我——插件在解释器发现阶段掉坑了。
2. AI 介入:协作 Debug 启动
Step 1:AI 先问清需求
AI:你想用 uv 还是标准 venv?
我:uv,极客当然要用新玩意。
Step 2:AI 自动帮我用 uv 创建 .venv
AI:虚拟环境已建好,激活即可。
我:source .venv/bin/activate,OK。
Step 3:AI 贴心提示
AI:如果 GUI 还在“Discovering”,可以手动选解释器、检查 Python 插件、重启 Cursor、设置 .vscode/settings.json
,还可以看 Output 日志。
Step 4:我反馈
我:都试了,还是卡住,Cursor 里就是“Discovering Python Interpreters”。
Step 5:AI 继续排查
AI:请问你用的什么编辑器?
我:Cursor。
AI:那你可以试试:
- 手动选
.venv/bin/python
- 检查 Python 插件日志
- 检查
.vscode/settings.json
- 检查系统里有无多余 Python 版本
- 甚至用标准 venv 测试兼容性
3. 进入极客 Debug 模式
Step 6:AI 自查环境
AI:让我自查下你的 .venv 结构和 Python 路径。
.venv/bin/python
→/opt/homebrew/opt/python@3.13/bin/python3.13
- Python 3.13.3,虚拟环境结构标准
- which python/which python3 都指向 .venv
AI 结论:你的虚拟环境没毛病,问题在于 Cursor 的 Python 插件解释器发现机制。
4. 深入 Output 日志,真相渐现
Step 7:AI 指导我贴 Output 日志
我:贴了 Output 日志,里面有一堆解释器扫描和报错。
Step 8:AI 逐行分析日志
- 插件扫描到
.venv/bin/python
,能正确识别 3.13.3 - 但也扫描到
~/.pyenv/versions/3.10.15/bin/python
,报错缺libintl.8.dylib
- 这是 pyenv 在 Intel Mac 上装的 Python 3.10.15,迁移到 M4 后架构/依赖不兼容
- 插件在解释器发现阶段被 pyenv 的遗留目录拖慢甚至卡死
AI 结论:问题根源是 pyenv 的历史遗留目录,Cursor 插件扫描解释器时遇到报错,导致“Discovering”卡住。
5. 极客式解决方案
Step 9:我问能否用 uv 删除 pyenv 解释器
AI:uv 只管虚拟环境,不管全局 Python 版本。你可以直接 rm -rf ~/.pyenv/versions/3.10.15
,一刀切。
Step 10:我执行删除
- 直接
rm -rf ~/.pyenv/versions/3.10.15
- 重启 Cursor,问题消失,插件秒识别 .venv,开发体验恢复丝滑
6. 终极总结:人与 AI 协作 Debug 的极客范本
过程回顾
- AI 不是简单给出答案,而是每一步都在引导、验证、分析,和我一起排查所有可能性。
- 从环境自查、插件配置、日志分析,到最终定位 pyenv 遗留目录,AI 全程参与,极大提升了排查效率。
- 过程中我也不断反馈实际操作和现象,AI 根据新信息动态调整建议,真正实现了“人机协作 Debug”。
极客经验
- 系统迁移后,历史遗留目录是大坑
pyenv/conda 这类多版本管理工具,目录残留会让 IDE 插件掉坑。 - IDE 插件解释器发现机制很“贪心”
只要目录在,就会递归扫描,哪怕解释器不可用也会报错拖慢。 - 日志是极客 Debug 的第一生产力
Output 日志能直接暴露问题根源,别怕信息量大,逐行分析总能找到线索。 - AI 是极客的最佳 Debug 伙伴
能自动化环境自查、日志分析、方案建议,极大提升排查效率和体验。 - 大胆 rm -rf,极客的魄力
明确问题根源后,果断清理历史遗留,环境即刻清爽。
结语
这次 Debug 之旅,是人与 AI 协作的极客范本。
AI 不只是工具,更是并肩作战的 Debug 伙伴。
希望这份记录能帮到所有在环境迁移、工具兼容、IDE 插件卡死等问题中挣扎的极客们。
Debug,不止于人,更在于协作。