PyCharm 2025.3 Help

自动导入

当您引用尚未导入的类时,PyCharm 会帮助您定位该文件并将其添加到导入列表。 您可以根据设置导入单个类或整个包。

导入语句会添加到导入部分,但插入符号不会从当前位置移动,您当前的编辑会话也不会中断。 此功能称为 导入助手。 由于无法通过命令行进行导入优化,在 PyCharm 中,首选使用 导入助手 来处理导入。

同样适用于 XML 文件。 当您 键入具有未绑定命名空间的标记时,导入助手会建议创建命名空间,并提供适当的选项列表。

自动添加导入语句

如果没有可供选择的选项,您可以将 IDE 配置为自动添加导入语句。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 自动导入

  2. Python 部分,配置自动导入:

    • 选择 显示import 弹出窗口(P) ,在键入缺少导入语句的类名时自动显示导入弹出窗口。

    • 选择 首选的import 样式 选项之一来定义导入语句的生成方式。

禁用导入工具提示

禁用工具提示时,未解析的引用会以下划线标出,并用红色灯泡图标 快速修复按钮 标记。 要查看建议列表,点击此图标(或按 Alt+Enter ),然后选择 导入类

禁用所有工具提示

  • 将鼠标悬停在编辑器右上角的检查小部件上,点击 更多 ,然后禁用 显示自动导入工具提示 选项。

禁用自动导入

如果您想完全禁用自动导入,请确保:

优化导入

优化import 功能可帮助您根据 设置 | 编辑器 | 代码样式 | <language> | Import 中指定的规则,移除未使用的导入,并一次性整理当前文件或目录中所有文件的导入语句。

优化所有导入

  1. 项目 工具窗口中选择一个文件或目录(View | 工具窗口 | 项目)。

  2. 执行以下任一操作:

    • 在主菜单中,转到 代码 | 优化import (或按 Ctrl+Alt+O)。

    • 在上下文菜单中,选择 优化import

  3. (如果您选择了目录)选择是要优化该目录中所有文件的导入,还是仅优化本地修改的文件(如果您的项目受版本控制),然后点击 运行

在单个文件中优化导入

  1. 将插入符号置于导入语句处,然后按 Alt+Enter ,或使用 意图操作按钮 图标。

  2. 选择 优化import

移除 use 语句

在提交时优化导入

如果您的项目受版本控制,您可以将 PyCharm 配置为在将更改提交到 VCS 之前优化已修改文件中的导入。

  1. Alt+0 打开 提交 工具窗口,然后点击 显示提交选项 设置按钮

  2. 点击 显示提交选项 ,并在提交消息区域选中 优化import 复选框。

    在提交前优化导入

在保存时自动优化导入

您可以将 IDE 配置为在更改被 保存 时自动优化已修改文件中的导入。

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | 保存时的操作

  2. 启用 优化import(O) 选项。

    此外,在 所有文件类型 列表中选择要优化导入的文件类型。

  3. 应用更改并关闭对话框。

在重新格式化文件时优化导入

您可以让 PyCharm 在每次重新格式化文件时优化该文件中的导入。

  • 在编辑器中打开该文件,按 Ctrl+Alt+Shift+L ,并确保在打开的 重新格式化文件 对话框中选中 优化导入 复选框。

    重新格式化文件对话框

此后,每次您在该项目中按 Ctrl+Alt+L 时,PyCharm 都会自动优化其导入。

为文件夹中的所有文件优化导入

  1. 项目 工具窗口中右键点击某个文件夹,然后选择 优化导入

  2. 优化导入 对话框中,点击 运行

即时创建导入

即时导入包

  1. 在编辑器中开始键入名称。 如果该名称引用了尚未导入的类,将出现以下提示:

    导入弹出窗口

    未解析的引用将以下划线标出,您必须显式地 调用意图操作 &#xa0; 添加导入 &#xa0;。

  2. Alt+Enter。 如果有多个选项,请从列表中选择所需的导入。

    选择要导入的类

您可以使用项目设置(设置 | 编辑器 | 常规 | 自动导入 )中 自动导入 页面提供的以下选项来定义 Python 代码的首选导入样式:

from <module> import <name>

import <module>.<name>

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 符号时添加导入语句。

在代码补全时添加 ES6 导入

配置在补全时自动导入

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

在代码补全时添加 ES6 导入
  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 自动导入

  2. 在打开的 自动导入 页面上,使用 TypeScript/JavaScript 区域中的复选框启用或禁用在代码补全时生成导入。

忽略缺失的导入语句

如果您的代码中使用的模块没有对应的存根,PyCharm 可能会显示缺失语句错误。 要抑制此错误消息,请使用 # type: ignore 注释:

忽略缺失的导入语句
最后修改日期: 2025年 12月 2日