PyCharm 运行 Python 文件仅显示 unittest 的解决方法
在 PyCharm 中运行 Python 文件时,如果右键菜单只显示“Run in unittest”,通常是因为文件名或代码中包含“test”字符串,导致 IDE 自动将其识别为单元测试文件。本文介绍两种解决方法:一是修改文件名或函数名以避开检测;二是通过设置将默认测试运行器从 Unittest 改为 py.test 或其他选项,从而恢复正常的运行方式。
问题现象与原因
当你在 PyCharm 中右键点击一个 Python 文件并尝试运行它时,如果菜单中只显示“Run in unittest”而没有常规的“Run 'filename'”选项,这通常是由以下原因引起的:
- 文件名包含“test”:例如文件名为
test_script.py。 - 代码内容包含“test”:例如函数名或类名中包含
test_或Test。
PyCharm 默认将包含这些关键词的文件识别为单元测试文件,因此会尝试使用 unittest 框架来运行它们,而不是作为普通脚本执行。

解决方法一:修改文件名或代码
这是最简单的解决方式。你可以尝试以下操作:
- 修改文件名:将文件名中的“test”部分移除或更改。例如,将
test_script.py改为script.py。 - 修改代码:如果文件名不能更改,可以尝试修改函数名或类名,使其不再包含“test”字符串。例如,将
def test_main():改为def main():。
修改后,重新右键点击文件,应该就能看到正常的“Run 'filename'”选项了。
解决方法二:更改默认测试运行器
如果你希望保留文件名或代码中的“test”字符串,可以通过更改 PyCharm 的设置来解决这个问题。具体步骤如下:
- 打开 PyCharm 的设置界面:
File->Settings(macOS 用户为PyCharm->Preferences)。 - 在左侧导航栏中,依次展开:
Tools->Python Integrated Tools。 - 找到 Default test runner 选项。
- 将默认测试运行器从
Unittests更改为其他选项,例如py.test或No tests。
注意:如果选择 py.test 但提示未安装,你需要先通过命令行安装 py.test 库:
pip install pytest完成设置后,重启 PyCharm 或重新加载项目,再次尝试运行文件,应该就能正常执行了。
总结
PyCharm 将包含“test”的文件识别为单元测试文件是一个常见的设计,旨在方便开发者进行单元测试。如果你希望运行普通脚本,可以通过修改文件名或代码来避开这一机制,或者通过更改默认测试运行器来调整 IDE 的行为。希望以上方法能帮助你解决问题。
以上就是 PyCharm 运行 Python 文件仅显示 unittest 的解决方法,更多关于 PyCharm 配置的资料请关注本站其它相关文章!
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













