问题背景
很多人写Python脚本时，习惯用testxxx.py命名临时验证代码。但在PyCharm里，右键直接运行这个文件，不会当成普通Python脚本执行，而是自动触发测试运行器（pytest/unittest）。
现象：
- 右键菜单优先显示
Run 'Tests in testxxx.py'，而不是Run 'testxxx.py' - 代码不会从
if __name__ == '__main__':入口执行 - 控制台输出测试框架的日志，找不到你打印的业务输出
- 部分版本还会附带代码覆盖率提示，文件侧边出现
not covered
说明：PyCharm内置自动测试发现机制，只要文件名匹配
test*.py/*_test.py，就会被索引识别为测试文件，这是IDE层面行为，不是Python语言本身特性。
常规无效尝试（避坑）
网上很多教程提到的方法，在新版/部分旧版PyCharm中会失效：
- 修改
Default test runner为unittest：不能关闭识别，只是切换测试引擎，依旧会当成测试跑 - 寻找
python.testing.discovery.enabled：部分PyCharm版本没有这个注册表项，找不到属于正常情况 - 删除已有测试配置：只能清理已保存的配置，右键新建临时运行依然会自动生成测试配置
终极方案：关闭通用测试发现注册表开关
适用场景：批量处理大量
testxxx.py文件，一次性全局关闭自动识别，不需要逐个新建Python运行配置。
操作步骤
- 打开PyCharm，按快捷键
Ctrl+Alt+Shift+/（Windows）；Mac：Cmd+Alt+Shift+/ - 在弹出菜单选择
Registry...，打开IDE注册表面板 - 在列表找到：
python.tests.enableUniversalTests - 取消勾选该项，点击Close
- 重启PyCharm（必须重启，注册表修改生效）
✅ 效果：
重启之后，所有testxxx.py文件不再被PyCharm自动识别为测试文件。右键菜单默认变成普通Run 'testxxx.py'，代码正常走if __name__ == '__main__':执行，不再进入测试模式。
⚠️ 副作用提醒
关闭 python.tests.enableUniversalTests 之后：
- PyCharm不再自动扫描、发现项目内任何测试用例
- 如果你项目里真的写了pytest/unittest单元测试，IDE不会自动识别测试函数，不能在代码左侧点击绿色小三角单独运行单条测试
适合：写大量test命名的验证脚本，几乎不用PyCharm自带单元测试功能 的开发者。
如果后续需要写单元测试，重新勾选该选项，重启PyCharm即可恢复。
备选方案（不想全局关闭测试能力时使用）
如果偶尔需要单元测试，不建议动注册表，可以用下面两种方式：
方案1：手动创建普通Python运行配置（单文件）
- 右上角下拉框 →
Edit Configurations... - 删除左侧所有
Python Tests类型配置（残留配置会干扰右键） - 左上角
+→ 选择 Python（不是Python Tests） - Script path选中你的
testxxx.py，保存配置 - 右上角选中这个配置运行，就是普通脚本。
缺点：只能针对单个文件，文件多的时候操作繁琐。
方案2：从终端运行（完全绕开PyCharm运行器）
直接使用内置Terminal执行：
bash
python testxxx.py完全不受PyCharm测试识别机制影响，适合快速调试。
额外清理建议
- 清理缓存：
File→Invalidate Caches...，勾选清理缓存，重启IDE，消除旧索引残留 - 检查覆盖率：如果侧边栏还有
not covered，关闭Coverage运行配置，不要用带覆盖率的选项启动 - 文件夹：存放脚本的目录不需要蓝色（测试目录标记），蓝色目录只是附加规则，核心根源还是上面的通用测试发现开关
总结
- 根源：PyCharm的
python.tests.enableUniversalTests控制全局自动测试发现 - 最优解：关闭这个注册表项，重启IDE，一次性批量解决所有test命名文件被当成测试的问题
- 取舍代价：牺牲IDE自动识别单元测试的能力，适合写验证脚本的场景
- 保留单元测试能力：不要修改注册表，使用手动Python配置或者终端运行