自动导入
当您引用尚未导入的类时,PyCharm 会帮助您定位该文件并将其添加到导入列表。 您可以根据设置导入单个类或整个包。
导入语句会添加到导入部分,但插入符号不会从当前位置移动,您当前的编辑会话也不会中断。 此功能称为 导入助手。 由于无法通过命令行进行导入优化,在 PyCharm 中,首选使用 导入助手 来处理导入。
同样适用于 XML 文件。 当您 键入具有未绑定命名空间的标记时,导入助手会建议创建命名空间,并提供适当的选项列表。
自动添加导入语句
如果没有可供选择的选项,您可以将 IDE 配置为自动添加导入语句。
按 Ctrl+Alt+S 打开设置,然后选择 。
在 Python 部分,配置自动导入:
选择 显示import 弹出窗口(P) ,在键入缺少导入语句的类名时自动显示导入弹出窗口。
选择 首选的import 样式 选项之一来定义导入语句的生成方式。
禁用导入工具提示
禁用工具提示时,未解析的引用会以下划线标出,并用红色灯泡图标
标记。 要查看建议列表,点击此图标(或按 Alt+Enter ),然后选择 导入类。
禁用所有工具提示
将鼠标悬停在编辑器右上角的检查小部件上,点击
,然后禁用 显示自动导入工具提示 选项。
禁用自动导入
如果您想完全禁用自动导入,请确保:
已禁用 自动插入导入语句。
优化导入
优化import 功能可帮助您根据 中指定的规则,移除未使用的导入,并一次性整理当前文件或目录中所有文件的导入语句。
优化所有导入
在 项目 工具窗口中选择一个文件或目录()。
执行以下任一操作:
在主菜单中,转到 (或按 Ctrl+Alt+O)。
在上下文菜单中,选择 优化import。
(如果您选择了目录)选择是要优化该目录中所有文件的导入,还是仅优化本地修改的文件(如果您的项目受版本控制),然后点击 运行。
在单个文件中优化导入
将插入符号置于导入语句处,然后按 Alt+Enter ,或使用
图标。
选择 优化import。

在提交时优化导入
如果您的项目受版本控制,您可以将 PyCharm 配置为在将更改提交到 VCS 之前优化已修改文件中的导入。
按 Alt+0 打开 提交 工具窗口,然后点击 显示提交选项
。
点击
,并在提交消息区域选中 优化import 复选框。

在保存时自动优化导入
您可以将 IDE 配置为在更改被 保存 时自动优化已修改文件中的导入。
按 Ctrl+Alt+S 打开设置,然后选择 。
启用 优化import(O) 选项。
此外,在 所有文件类型 列表中选择要优化导入的文件类型。
应用更改并关闭对话框。
在重新格式化文件时优化导入
您可以让 PyCharm 在每次重新格式化文件时优化该文件中的导入。
在编辑器中打开该文件,按 Ctrl+Alt+Shift+L ,并确保在打开的 重新格式化文件 对话框中选中 优化导入 复选框。

此后,每次您在该项目中按 Ctrl+Alt+L 时,PyCharm 都会自动优化其导入。
为文件夹中的所有文件优化导入
在 项目 工具窗口中右键点击某个文件夹,然后选择 优化导入。
在 优化导入 对话框中,点击 运行。
即时创建导入
即时导入包
在编辑器中开始键入名称。 如果该名称引用了尚未导入的类,将出现以下提示:

未解析的引用将以下划线标出,您必须显式地 调用意图操作   添加导入  。
按 Alt+Enter。 如果有多个选项,请从列表中选择所需的导入。

您可以使用项目设置( )中 自动导入 页面提供的以下选项来定义 Python 代码的首选导入样式:
from <module> import <name> | import <module>.<name> |
|---|---|
![]() | ![]() |
切换相对导入与绝对导入
PyCharm 帮助您在源根内整理 相对和 绝对导入。 借助特定的 意图操作 ,您可以将绝对导入转换为相对导入,反之亦然。

如果您的代码包含任何相对导入语句,PyCharm 在修复缺失的导入时将添加相对导入。

请注意,相对导入仅在当前源根内有效:无法从其他源根相对导入包。
提示您转换导入的意图操作默认启用。 要将其禁用,请打开项目 设置 (Ctrl+Alt+S ),选择 ,并取消选中 将绝对导入转换为相对导入 和 将相对导入转换为绝对导入。

当您补全 ES6 符号或 CommonJS 模块时,PyCharm 会自行决定导入语句的样式,或显示一个弹出窗口,供您选择所需的样式。 详细了解 JavaScript 中的自动导入。
在代码补全时添加导入语句
PyCharm 会在您在 Python 代码中引用任何模块成员或包并调用代码补全时自动添加导入语句。 代码补全时的自动导入也适用于一些常用的包名别名,例如 np 对应 numpy ,或 pd 对应 pandas。
PyCharm 还会在您补全导出的 JavaScript 或 TypeScript 符号时添加导入语句。

配置在补全时自动导入
您可以禁用在补全时自动导入,转而使用快速修复:

在 设置 对话框(Ctrl+Alt+S )中,转到 。
在打开的 自动导入 页面上,使用 TypeScript/JavaScript 区域中的复选框启用或禁用在代码补全时生成导入。
忽略缺失的导入语句
如果您的代码中使用的模块没有对应的存根,PyCharm 可能会显示缺失语句错误。 要抑制此错误消息,请使用 # type: ignore 注释:


