PyCharm 运行 Python 脚本总自动进 Test 模式？附 RT-DETRv2 依赖缺失终极排坑

PyCharm 运行 Python 脚本总自动进 Test 模式附 RT-DETRv2 依赖缺失终极排坑大家好我是一名工业视觉算法工程师最近在 Windows 上部署 RT-DETRv2 模型时踩了两个非常典型的坑PyCharm 误把普通脚本当成单元测试运行以及faster_coco_eval依赖缺失导致的报错。本文把这两个问题的解决方法一次性讲透帮你彻底告别调试烦恼一、问题现象1. PyCharm 自动进入 Test 模式点击运行脚本后PyCharm 直接弹出“测试结果”面板显示“2 个测试已失败”根本不会执行你写的业务代码。2. 同时触发依赖缺失报错在测试模式下控制台直接抛出ModuleNotFoundError:No module namedfaster_coco_eval报错指向coco_dataset.py的from faster_coco_eval.utils.pytorch import FasterCocoDetection这一行导致脚本直接终止。二、问题根源分析1. PyCharm 为什么会自动进 Test 模式PyCharm 有个自动检测机制当你的脚本路径、文件名比如包含test字样或结构符合单元测试的特征时会默认以unittest/pytest模式运行而不是普通 Python 脚本。2.faster_coco_eval是什么它是一个高性能的 COCO 评估工具RT-DETRv2 官方代码中coco_dataset.py直接依赖它导入评估类。如果没安装这个包代码一导入就会报错而 PyCharm 的测试模式会放大这个问题让你误以为是脚本逻辑的问题。三、分步解决先根治 Test 模式再修复依赖步骤 1彻底关闭 PyCharm 自动测试永久生效方法 1修改运行配置推荐一键切换点击 PyCharm 右上角的运行配置下拉框选择Edit Configurations在左侧列表中删除所有带测试图标的配置图标是绿色的“双勾”点击左上角的→ 选择Python新建一个普通运行配置Script path选择你的 Python 脚本比如tools/load_test.pyParameters输入你的命令参数比如-c configs/rtdetrv2/xxx.ymlPython interpreter选择你的虚拟环境比如rtdetr点击Apply保存以后运行就会默认用这个配置不会再进测试模式了。方法 2禁用默认测试运行器终极根治打开 PyCharm 设置File → Settings → Tools → Python Integrated Tools找到Testing模块把Default test runner改成 No runner 点击OK保存重启 PyCharm 后它就不会再自动识别测试文件了。步骤 2安装faster_coco_eval依赖解决导入报错在你的虚拟环境终端中直接运行安装命令pipinstallfaster-coco-eval注意这个包依赖 C 编译环境如果安装失败可以先安装Microsoft Visual C Build Tools再重试。四、验证效果完成以上两步后重新运行你的脚本会看到正常的 Python 执行日志而不是测试面板依赖导入报错也会消失Not init distributed mode. 测试数据集加载RT-DETRv2 官方专用 ✅ 成功加载 train_dataloader 第 1 个 batch: - 图片 shape: torch.Size([4, 3, 640, 640]) - 标注 bboxes: 4 - 标注 labels: 4 数据读取成功配置完全正常五、避坑总结优先改运行配置这是解决 PyCharm 自动进测试模式最直接的方法比修改全局设置更灵活。依赖问题别忽略faster_coco_eval是 RT-DETRv2 的强依赖安装后不仅能解决导入报错后续模型训练的评估环节也会用到。临时方案如果赶时间直接在终端运行python 你的脚本.py永远不会触发 PyCharm 的测试模式。