关闭自动导入弹窗需在settings→editor→auto-import中取消勾选show import popup,此时未导入符号仍标红并显示灯泡图标,可按alt+enter手动导入;如需彻底禁用自动插入import,还需取消add unambiguous imports on the fly。

关闭自动导入弹窗(Import popup)
PyCharm 默认会在你输入未导入的类或函数名(比如 json.loads)时,弹出一个带“Import”选项的提示窗口。这个弹窗能快速帮你补全 import,但频繁弹出确实干扰编码节奏。
关闭它最直接的方式是:点击编辑器右下角那个“小人头像”图标 → 取消勾选 Show import popup。
或者走设置路径:Settings → Editor → Auto-Import(macOS 是 Preferences),把 Show import popup 前面的复选框取消。
- 取消后,未导入的符号仍会标红波浪线,左侧出现红色灯泡图标
- 此时按
Alt+Enter仍可手动触发导入建议,只是不再自动弹窗 - 该设置只影响弹窗行为,不禁止后续的
Alt+Enter导入操作
彻底禁用自动插入 import 语句
如果你连 Alt+Enter 自动补 import 都不想用(比如团队强制统一 import 规范,或你在写教学示例需手动控制每一步),就得进一步关掉“自动插入”能力。
在同一个设置页 Settings → Editor → Auto-Import 中:
PyCharm 2026.2提供 JetBrains 官方 2026.2 版本安装包,适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
- 取消
Add unambiguous imports on the fly—— 这项控制“无歧义时直接插入 import”,比如只存在一个requests模块,IDE 就会悄悄加一行import requests - 同时确保
Show import popup已关闭(否则弹窗里点“Import class”仍会插入) - 注意:
Optimize Imports(Ctrl+Alt+O)功能不受此影响,它只清理已有 import,不参与新增
为什么关了还弹?检查是否被其他设置覆盖
有时关完设置仍出现自动 import,常见原因有:
- 当前文件属于某个
Sources Root或Content Root,而 PyCharm 在该根目录下启用了项目级自动导入策略(比如通过.idea/misc.xml配置) - 你正在编辑的是
scratch file(临时文件),这类文件默认启用更激进的辅助行为,需单独在Settings → Editor → General → Console & Scratch中调整 - 装了第三方插件(如某些 Python 分析插件)重写了 import 行为,可去
Settings → Plugins暂时禁用非必要插件验证
最稳妥的验证方式:新建一个纯 Python 文件(不在任何已配置源根下),测试是否还自动插入 —— 如果不弹了,说明原项目配置或插件干扰了行为。
关掉之后要注意什么
关闭自动导入后,PyCharm 不再帮你补 import,但也不会主动提醒你缺了啥 —— 红色波浪线和灯泡图标依然存在,只是触发逻辑变了。
真正容易被忽略的是:动态使用模块的场景(比如 importlib.import_module("xxx")、插件注册、__init__.py 中的显式导入)会被 PyCharm 静态分析误判为“未使用”,进而可能在你执行 Optimize Imports 时被删掉。这种情况下,得靠 # noinspection PyUnresolvedReferences 注释来保命。










