PyCharm 2025.2 Help

自动导入

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

导入语句会被添加到导入部分，但插入符不会从当前位置移动，且您当前的编辑会话不会中断。 此功能称为 导入助手。 使用 导入助手是处理 PyCharm 中导入的首选方式，因为命令行不支持导入优化。

同样的功能也适用于 XML 文件。 当您 输入一个未绑定命名空间的标签时，导入助手会建议创建一个命名空间并提供适当的选项列表。

自动添加导入语句

您可以配置 IDE，使其在没有可供选择的选项时自动添加 import 语句。

  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. 在 项目 工具窗口中右键点击某个文件夹，然后选择 优化 import。

  2. 在 优化 import 对话框中，点击 运行。

动态创建导入

动态导入包

  1. 在编辑器中开始输入一个名称。 如果该名称引用了尚未导入的类，则会出现以下提示：

    导入弹窗

    未解析的引用将被下划线标记，您需要 显式调用意图操作 &#xa0; 添加导入 &#xa0;。

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

    选择要导入的类

您可以通过项目设置（设置 | 编辑器 | 常规 | 自动导入 ）中 自动导入 页面提供的以下选项定义您首选的 Python 代码导入样式：

从 <module> 导入 <name>

导入 <module>.<name>

from <module> import <name> 样式
import <module>.<name> 样式

切换相对导入和绝对导入

PyCharm 帮助您在源根内组织 相对和 绝对导入。 通过特定的 意图 ，您可以将绝对导入转换为相对导入，或将相对导入转换为绝对导入。

将绝对导入转换为相对导入

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

使用相对导入语句修复缺失的导入

请注意，相对导入仅在当前源根内有效：您无法从另一个源根相对导入包。

提示您转换导入的意图默认是启用的。 要禁用它们，请打开项目 设置 （Ctrl+Alt+S ），选择 编辑器 | 意图 ，并取消选中 将绝对导入转换为相对导入 和 将相对导入转换为绝对导入。

用于转换导入的意图

当您完成一个 ES6 符号或 CommonJS 模块时，PyCharm 会自行决定导入语句的样式，或者显示一个弹出窗口供您选择所需的样式。 从 JavaScript 中的自动导入 中了解更多。

在代码补全时添加导入语句

当您在 Python 代码中引用任何模块成员或包并调用代码补全时，PyCharm 会自动添加导入语句。 代码补全时自动导入也适用于一些流行的包名称别名，例如 np 对应 numpy 或 pd 对应 pandas。

PyCharm 还会在您完成导出的 JavaScript 或 TypeScript 符号时添加导入语句。

在代码补全时添加 ES6 导入

配置代码补全时的自动导入

您可以在补全时禁用自动导入，并改用快速修复：

在代码补全时添加 ES6 导入

  1. 在 设置 对话框 (Ctrl+Alt+S) 中，前往 编辑器丨常规丨自动导入。

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

忽略缺失的导入语句

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

忽略缺失的导入语句
最后修改日期： 2025年 9月 26日
重新格式化并重新排列代码代码补全