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

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

在 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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。