PyCharm克隆Git项目后Run/Debug选项异常及配置恢复咨询

差异原因 #

• 本地新建项目时，IDE会自动识别项目结构，默认把根目录纳入测试扫描范围，无需手动操作；但克隆Git仓库的项目时，IDE不会自动做这个隐式识别，得靠明确配置触发自动检测逻辑。
• 克隆后IDE直接绑定了pytest作为指定运行器，而非自动检测模式，导致右键菜单和运行配置都切换成了pytest专属的，不是原来的通用自动检测模板。

完整恢复步骤 #

1. 重置IDE缓存与测试运行器设置 #

• 打开Settings/Preferences → Tools → Python Integrated Tools，把Default test runner设为Autodetect。
• 点击File → Invalidate Caches...，选择Invalidate and Restart，强制IDE重新扫描项目，清除克隆后残留的旧缓存配置。

2. 配置pytest扫描根目录（无需手动标记Test Sources Root） #

• 检查项目根目录是否存在pytest.ini、tox.ini或setup.cfg：
  • 没有的话，新建pytest.ini，写入基础配置即可：

    [pytest]
    testpaths = .
    

  • 已有配置文件的话，确保testpaths包含根目录（比如testpaths = .），让pytest默认扫描根目录下的所有测试文件。
• 如果之前标记过Test Sources Root，右键根目录选择Mark Directory as → Unmark as Test Sources Root，等待IDE重新索引完成。

3. 验证恢复效果 #

• 右键项目根目录，确认出现Run/Debug 'Python tests in ...'选项。
• 运行后查看生成的配置，应该匹配Python tests -> Autodetect模板。
• 子目录/模块的右键菜单也会恢复成通用的Run/Debug 'Python tests in ...'。

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