代码分析#

代码分析窗格可在不实际执行代码的情况下,检测代码中的样式问题、不良实践、潜在错误和其他质量问题。根据这些结果,它还会为您的代码提供一个整体质量评分。Spyder 的代码分析器由业界领先的 Pylint 后端提供支持,该后端能够智能地检测范围广泛且可自定义的潜在错误、不良实践、质量问题、样式违规等。

Spyder Pylint pane, showing numerous issues discovered in a file

使用代码分析器#

您可以直接在编辑器中点击任意位置来选择要分析的文件。要运行分析,请按下可配置的快捷键(默认为F8),从菜单栏中选择源 ‣ 运行代码分析,或点击代码分析窗格中的分析按钮。如果代码分析窗格不可见,您可以在视图 ‣ 窗格 ‣ 代码分析下打开它。默认情况下,所有标准检查都会运行。要直接跳转到编辑器中由失败检查突出显示的那一行,只需点击其名称。

Spyder Pylint pane, showing running analysis and clicking failed check

您也可以在窗格工具栏中的路径输入框中手动输入要检查的文件路径。分析器既可以处理单个脚本,也可以处理整个 Python 包(包含__init__.py文件的目录)。

Spyder Pylint pane, showing running analysis browsing file

使用停止按钮取消文件分析;如果分析失败,点击输出按钮以查明原因。如果 Pylint 成功,输出将显示所选文件的原始纯文本分析结果,方便您浏览和复制/粘贴完整的消息名称和描述。

Spyder Pylint pane, showing output

最后,您可以点击文件名字段中的下拉菜单或按下下拉箭头,以查看之前分析的结果。

Spyder Pylint pane, showing history

选项菜单#

Spyder 应该记住的最近运行次数可以在“代码分析选项”菜单中的历史记录对话框中自定义。

Spyder Pylint pane, customizing history dialog

您还可以使用选项菜单中对应的选项来展开或折叠窗格中的一个或所有部分。

Spyder Pylint pane, expanding and collapsing sections

高级选项#

您可以通过在相应的作用域中添加# pylint: disable=MESSAGE-NAMES注释,在行、块或文件/模块级别关闭某些消息,其中MESSAGE_NAMES应替换为逗号分隔的(或单个)Pylint 消息名称列表。例如,一条指令可能看起来像# pylint: disable=invalid-name,或者# pylint: disable=fixme, line-too-long

Spyder Pylint pane, showing disabling a message locally

或者,您可以通过编辑用户文件夹中的.pylintrc配置文件来全局禁止特定消息并调整其他 Pylint 设置。如果该文件不存在,您可以在用户目录中,从 Anaconda Prompt(在 Windows 上)或您的终端(macOS/Linux)运行pylint --generate-rcfile > .pylintrc来生成它。有关配置 Pylint 的更多详细信息,请参阅Pylint 文档

Spyder Pylint pane, disabling a message globally in the .pylintrc