PyCharm 运行 Python 文件仅显示 unittest 的解决方法

月亮慢半拍
月亮慢半拍
发布时间:2026-10-11 | 4人浏览过
原创

在 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 框架来运行它们,而不是作为普通脚本执行。

解决方法一:修改文件名或代码

这是最简单的解决方式。你可以尝试以下操作:

  1. 修改文件名:将文件名中的“test”部分移除或更改。例如,将 test_script.py 改为 script.py。
  2. 修改代码:如果文件名不能更改,可以尝试修改函数名或类名,使其不再包含“test”字符串。例如,将 def test_main(): 改为 def main():。

修改后,重新右键点击文件,应该就能看到正常的“Run 'filename'”选项了。

解决方法二:更改默认测试运行器

如果你希望保留文件名或代码中的“test”字符串,可以通过更改 PyCharm 的设置来解决这个问题。具体步骤如下:

  1. 打开 PyCharm 的设置界面:File -> Settings(macOS 用户为 PyCharm -> Preferences)。
  2. 在左侧导航栏中,依次展开:Tools -> Python Integrated Tools。
  3. 找到 Default test runner 选项。
  4. 将默认测试运行器从 Unittests 更改为其他选项,例如 py.test 或 No tests。

注意:如果选择 py.test 但提示未安装,你需要先通过命令行安装 py.test 库:

pip install pytest

完成设置后,重启 PyCharm 或重新加载项目,再次尝试运行文件,应该就能正常执行了。

总结

PyCharm 将包含“test”的文件识别为单元测试文件是一个常见的设计,旨在方便开发者进行单元测试。如果你希望运行普通脚本,可以通过修改文件名或代码来避开这一机制,或者通过更改默认测试运行器来调整 IDE 的行为。希望以上方法能帮助你解决问题。

以上就是 PyCharm 运行 Python 文件仅显示 unittest 的解决方法,更多关于 PyCharm 配置的资料请关注本站其它相关文章!

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表