本节介绍如何查看符号定义、显示文档参考以及使用查看参数信息功能。
在 PyCharm 中,您可以查看符号(例如标签、类、字段、方法或函数)在项目中的定义位置和方式。为此,IDE 具有快速定义弹出窗口。
要查看符号的定义,请在编辑器中选择它并按Ctrl+Shift+I(或单击
)。或者,Ctrl按住键,将光标悬停在任何符号上。PyCharm 将符号显示为链接并在工具提示中显示其定义。单击此链接可跳转到符号的定义。
您可以在“查找”工具窗口中打开定义。为此,请单击弹出窗口右上角的图标,然后单击
在查找工具窗口中打开。
要打开定义的源代码进行编辑并关闭弹出窗口,请单击图标,然后单击
编辑源( F4)。
快速类型定义功能允许您在弹出窗口中查看变量、字段、方法或任何其他符号的类型定义,而无需从您正在编辑的代码中切换。
将插入符号放在要查看其类型定义的符号上,然后选择
。要打开定义的源代码进行编辑并关闭弹出窗口,请单击图标,然后单击
编辑源( F4)。
PyCharm 没有此操作的默认键盘快捷键,但您可以在设置中手动配置它。有关如何配置自定义快捷键的更多信息,请参阅配置键盘快捷键。
参数信息弹出窗口显示方法和函数调用中的参数名称。在您在编辑器中键入左括号或从建议列表中选择方法后,PyCharm 会在 1 秒(1000 毫秒)内自动显示一个包含所有可用方法签名的弹出窗口。
如果弹出窗口已关闭或者您的 IDE配置为不自动显示弹出窗口,您可以显式调用它。为此,请按Ctrl+P(或单击 )。
默认情况下,参数信息弹出窗口显示简单的签名。您可以将 IDE 配置为显示包含方法名称和返回类型的完整签名。
在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,转到 ,然后选中Show full method signatures复选框。
确保在项目源路径中包含所需的第三方JavaScript 库。否则,参数名称将不会显示。
在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,转到 。
在Show the parameter info popup in ... 毫秒字段中,以毫秒为单位指定弹出窗口应该出现的时间。
如果您不希望弹出窗口自动出现,请清除Show the parameter info popup in ... milliseconds复选框。
嵌入提示是出现在编辑器中的特殊标记,可为您提供有关代码的其他信息,例如被调用方法期望的参数名称。其他类型的提示会通知您有关注释、方法参数、用法等(取决于语言)。
默认情况下启用一些提示。
镶嵌提示。
中微调镶嵌提示| 。有关每种类型的功能的详细说明,请参阅如果您不想看到特定方法的参数提示,您可以配置例外列表。默认情况下,异常列表包含许多预定义的方法。您可以从列表中删除一个方法以查看它的提示,或添加新方法以在编辑器中隐藏它们的提示。
在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,选择 并单击必要的语言。
在中间部分的列表中选择参数提示。
用于配置提示的选项在右侧可用。
将您不想看到提示的方法添加到排除列表部分。
将您不想看到提示的案例添加到排除列表部分。要添加案例,请单击代码中的内联提示,按下Alt+Enter并选择Do not show hints for current method。
应用更改并关闭对话框。
您可以通过快速文档功能直接从编辑器中获取任何符号的快速信息。当您将鼠标悬停在代码元素上时,它会在弹出窗口中向您显示代码文档。
PyCharm 识别根据PEP-257创建的内联文档。
将鼠标悬停在编辑器中所需的符号上。
将插入符号放在符号上并按Ctrl+Q(
)。Ctrl+Q再次按下可在文档工具窗口中打开此文档。
单击文档主题中的链接可预览顶级元素(在本例中:math)或相关类型(在本例中:float)的文档。
在弹出窗口中单击以更改字体大小、显示快速文档工具栏或转到源代码。
默认情况下,当您将鼠标悬停在代码元素上时,会出现快速文档弹出窗口。您可以将 IDE 配置为仅在显式调用快速文档功能后才显示弹出窗口。
单击弹出窗口并禁用“鼠标移动时显示”选项。
在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,转到 并清除在悬停时显示快速文档复选框。
在这种情况下,要查看插入符号处的符号文档,请按Ctrl+Q或选择其显示在工具窗口中。
。文档将显示在弹出窗口中,但您可以配置 IDE 以立即将在默认设置下,按Ctrl+Q(
) 打开快速文档会打开一个弹出窗口。您可以更改设置以在工具窗口中查看文档。在快速文档弹出窗口中,单击并禁用Show Documentation Popup First选项。
在“文档”工具窗口中,单击工具窗口工具栏上的图标并禁用“首先显示文档弹出窗口”选项。
您可以在工具窗口中打开特定代码元素的文档,并继续查看当前文件中其他元素的文档。
将插入符号放在所需的代码元素处,然后按Ctrl+Q。如果出现弹出窗口,Ctrl+Q请再次按下以切换到工具窗口。
文档选项卡上的星号 ( *
) 表示该选项卡未固定,因此其内容将替换为您在编辑器中选择的另一个代码元素的文档。
右键单击包含文档的选项卡或单击工具窗口工具栏上的图标并启用保留此文档选项。
之后,当前的文档选项卡将被固定。您可以返回编辑器并查看将在弹出窗口或工具窗口的新选项卡中打开的其他代码元素的文档。
外部文档在 Web 浏览器中打开必要的信息,以便您可以导航到相关符号并同时保留信息以供进一步参考。
PyCharm 显示SciPy、NumPy、PyGTK以及您为 Python 解释器安装的其他模块的文档。外部文档应在设置/首选项的外部文档页面中正确配置。
要在浏览器中查看插入符号处的符号文档,请按Shift+F1或选择
。要查看外部文档,您需要先配置文档 URL。PyCharm 附带 pandas、wx、kivy、PySide、PyQt5、PyQt4、matplotlib、pyramid、flask 和 gtk 的 URL。您可以修改预定义的 URL 集或在项目Settings/Preferences中添加新的 URL 。
在设置/首选项对话框 ( Ctrl+Alt+S) 打开 。
要添加新的文档 URL,请单击。在打开的对话框中,指定模块名称和相应外部文档的 URL。
如果外部文档位于本地,请指定它的本地路径。
。
要设置 URL 模式,请在可用宏字段中选择一个宏,然后单击插入按钮。
请注意,每个文档模块都有其特定的结构,因此在添加宏时要小心。
在 PyCharm 中,您可以通过以下方式识别表达式的类型:
将插入符号放在必要的代码元素上,然后按Ctrl+Shift+P(或从主菜单中选择
要将工具提示文本复制到剪贴板,请按住Alt(在 Linux 上,按住Ctrl+Alt)并单击工具提示。
如果当前方法或类声明不可见,您可以通过按 在工具提示中查看它Alt+Q。