PyCharm中“未使用引用”指Unused import、local variable或function parameter，基于作用域和保守静态分析标记，可能误报；可用Optimize Imports清理导入，Safe Delete移除函数/变量，并通过设置启用实时优化与警告。
PyCharm 里“未使用引用”指的是什么
PyCharm 标出的 Unused import、Unused local variable 或 Unused function parameter 都属于“未使用的引用”。它不光看变量是否被读取，还结合作用域、动态属性访问（如 getattr）、字符串反射（如 eval）等做保守判断——所以有时标红了但删掉会报错，这是正常行为。
用 Optimize Imports 快速清理未使用 import
这是最安全、最常用的一键操作，只处理 import 语句，不影响其他代码：
- 快捷键：
Ctrl+Alt+O（Windows/Linux）或Cmd+Alt+O（macOS） - 菜单路径：右键编辑区 → Optimize Imports，或 Code → Optimize Imports
- 它会自动移除重复导入、合并同类项（如把多个
from os import path, getcwd合成一行），并按 PEP 8 排序 - ⚠️ 注意：
__all__中显式声明的导入、带副作用的导入（如import PyQt5.QtCore触发插件注册）可能被误删，建议先检查 diff
用 Safe Delete 彻底移除未使用函数/变量/参数
对函数、类、局部变量这类非 import 元素，不能靠“优化导入”，得用 Safe Delete —— 它会扫描整个项目，确认无调用才允许删除：
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 选中目标标识符（如函数名
helper_func），按Alt+Delete（Windows/Linux）或Fn+Delete（macOS） - 弹窗显示所有引用位置；如果列表为空或只有注释/字符串，就说明真没被用
- 勾选 Search in comments and strings 可避免漏掉字符串里的硬编码调用（比如日志里写了
"calling helper_func"） - ⚠️ 注意：它不识别通过
getattr(obj, name_str)或globals()[name]动态调用的情况，这类需人工确认
开启自动检测和批量修复警告
PyCharm 默认已启用未使用引用检测，但默认不自动修复。要让它在保存时提示甚至自动删，需调整设置：
- 进入 Settings → Editor → Inspections → Python → Unused symbol
- 勾选
Unused local variable、Unused function parameter等子项，并设为 Warning 或 Weak Warning - 在右侧勾选 Optimize imports on the fly（实时优化导入）和 Remove unused imports on the fly（需 PyCharm 2022.3+）
- 保存后，新增的未使用 import 会在你敲完分号或换行时自动消失；已有警告则仍需手动触发
Optimize Imports或Safe Delete
真正麻烦的是跨文件动态调用、测试框架的 fixture 注入、或 pytest 的 @pytest.mark.parametrize 引用——这些地方 PyCharm 很难推断，删之前务必 grep 检查字符串匹配，不然运行时报 NameError 就晚了。
