PyCharm点击run按钮找不到原有可用模块 安装Cython speedup后报错

1. 确认运行时路径配置 #

先在test1文件最开头添加代码打印运行时环境信息：

import sys, os
print("Python搜索路径：", sys.path)
print("当前工作目录：", os.getcwd())

运行测试后核对输出：

• 检查Top_folder的绝对路径是否在sys.path列表中
• 检查当前工作目录是否为Top_folder路径
  如果路径未正常加载，说明Cython speedup安装后改动了调试器的路径注入逻辑，导致PyCharm标记的源根失效。

方案1：修正PyCharm运行配置 #

• 点击PyCharm右上角运行配置下拉框，选择「Edit Configurations」
• 找到对应test1的测试运行配置，确认「Working directory」设置为Top_folder的绝对路径
• 勾选「Add content roots to PYTHONPATH」和「Add source roots to PYTHONPATH」两个选项，保存后重新运行测试

方案2：代码内主动注入路径 #

如果调试器Cython扩展修改了路径加载优先级，可在test1的导入语句前主动添加项目根路径到搜索列表：

import sys
from pathlib import Path
# 从test文件路径向上回溯两级定位到Top_folder，添加到Python搜索路径
sys.path.insert(0, str(Path(__file__).parent.parent.resolve()))

from module.submodule1.foo import bar

方案3：禁用Cython speedup调试扩展 #

如果确认是该扩展导致的兼容问题，可临时关闭验证：

• 打开PyCharm设置 → 「Build, Execution, Deployment」 → 「Python Debugger」
• 取消勾选「Use Cython speedups」选项，重启PyCharm后重新运行测试

方案4：校验子模块完整性 #

• 确认module/submodule1目录下存在__init__.py文件（空文件即可），且存在foo.py文件
• 确认submodule1、foo等命名没有和已安装的第三方模块、Python内置模块重名，避免导入优先级冲突

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