PyCharm 2025.3 Help

集成工具

使用此页面配置依赖管理文件、默认测试运行器以及文档字符串的处理方式。

项目

说明

软件包需求文件

输入 需求文件 的名称,或点击浏览按钮,然后使用 选择路径 对话框从文件系统中选择所需的需求文件。

Pipenv 可执行文件路径

将 Pipenv 环境添加到 Python 项目需要此路径。 如果将其添加到 PATH 环境变量,系统可以自动检测到该路径。 要查找该路径,请按照特定于操作系统的 pipenv 安装过程。 示例:

  • C:\Users\jetbrains\AppData\Roaming\Python\Python37\Scripts\pipenv.exe (Windows)

  • /Users/jetbrains/.loca/bin/pipenv (macOS)

默认测试运行器

选择每次您在测试用例的上下文菜单中选择 运行 时,PyCharm 将建议的测试运行/调试配置。

可选项包括:

  • Unittests

  • pytest

  • Nosetests

  • Twisted Trial

在 Jupyter Notebook 中检测测试

如果您希望将 Jupyter Notebook 文件包含在单元测试检测范围内,请选中此复选框。

文档字符串格式

选择要由 PyCharm 识别的文档字符串格式。

根据所选的文档字符串格式,PyCharm 将生成存根文档注释,并在 显示快速文档 中呈现文本:

  • 纯文本 :在输入开引号后按下 Enter 或空格,将生成空存根;快速文档以纯文本形式显示。

  • reStructuredText :在输入开引号后按下 Enter 或空格,将根据 reStructuredText 格式生成存根文档注释;快速文档由 Docutils 呈现。

  • NumPy :在输入开引号后按下 Enter 或空格,将根据 NumPy 格式生成存根文档注释;快速文档由 Napoleon 和 Docutils 呈现。

  • Google :在输入开引号后按下 Enter 或空格,将根据 Google 格式生成存根文档注释;快速文档由 Napoleon 和 Docutils 呈现。

所有类型的文档字符串均具有:

  • 正确生成文档字符串

  • 在应用意图操作和快速修复后进行更新

  • 编码辅助

  • 节标题的自动补全

分析文档字符串中的 Python 代码

选中此复选框后,PyCharm 将高亮显示代码示例,并执行语法检查和代码检查。

未选中此复选框时,不会分析文档字符串中的代码片段。

stdlib 渲染外部文档。

允许在 视图 | 快速文档 中显示来自 http://docs.python.org 的标准库函数的文档。

Sphinx 工作目录

指定包含 .rst 文件和 conf.py 配置的文件夹路径。 PyCharm 使用它来识别自定义角色,并为 Sphinx 文档提供准确的高亮和渲染。

.txt 文件视为 reStructuredText

选中此复选框后,具有 .txt 扩展名的文件将与具有 .rst 扩展名的文件以相同方式高亮显示。

最后修改日期: 2025年 12月 2日