<p>PyCharm函数名下阴影通常源于拼写检查误判或未解析引用。悬停提示“Typo”属拼写检查，“Unresolved reference”则表明定义不可见；可分别通过禁用拼写检查、添加字典词、补全导入或添加# noinspection PyUnresolvedReferences注释精准解决。</p>
PyCharm 函数名下阴影是“拼写检查”误标
这不是语法高亮或类型提示，而是 PyCharm 把函数名当成了未定义的变量或拼写错误——尤其当你用 __getattr__、动态属性、装饰器注入方法，或函数名来自字符串调用（如 getattr(obj, func_name)）时，IDE 无法静态推导，就给函数名加灰色阴影（有时带波浪线），看着像 bug 其实是拼写检查在“多管闲事”。
验证方式：把鼠标悬停在带阴影的函数名上，如果提示类似 Typo: 'my_func' looks like a misspelled word 或 Unresolved reference 'xxx'，基本就是这个原因。
- 关闭拼写检查仅对当前文件生效：右键函数名 → Spellcheck → Disable inspection for this file
- 全局禁用拼写检查：Settings → Editor → Inspections → Proofreading → Typo，取消勾选
- 更推荐做法：保留拼写检查，但把函数名加入字典——Settings → Editor → Spelling → Dictionaries → Add，填入
my_func、get_data等常用函数名（支持通配符如*_handler）
阴影来自“未解析引用”而非拼写问题
如果悬停提示是 Unresolved reference 'xxx'，说明 PyCharm 没找到函数定义位置。常见于：
- 函数在运行时动态生成（如用
types.FunctionType构造） - 跨文件导入路径不规范（比如用了相对导入但没设
__init__.py，或from . import xxx在非包内执行） - 使用了
sys.path动态追加路径，但 PyCharm 没同步（需在 Settings → Project → Project Structure → Add Content Root 手动添加） - 函数定义在条件分支里（如
if False:下），PyCharm 静态分析直接跳过
临时解决：在函数调用前加类型注释 # type: ignore；长期建议补全导入或重构为可静态分析的结构。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
取消阴影但保留其他检查的精准方案
别关整个拼写或引用检查——容易漏真错误。针对性抑制更安全：
- 光标停在阴影函数名上，按
Alt+Enter（macOS 是⌥↩），选择Suppress for statement或Suppress for expression - 会自动生成
# noinspection PyUnresolvedReferences注释，只对该行生效 - 若想批量处理某类函数（如所有以
_api结尾的方法），可在 Settings → Editor → Inspections → Python → Unresolved references 里点击右下角…，添加忽略模式：*_api
注意：PyUnresolvedReferences 是检查 ID，不是错误信息文字，复制时别手误写成 Unresolved reference —— 后者无效。
阴影其实是 PyCharm 的“智能提醒”，别急着关
有时候阴影是好事：它暴露了真实隐患。比如你写了 user.save()，但 save 实际是 UserModel 类的方法，而当前对象类型被推断为 dict，那阴影就是在提醒你类型注解缺失或返回值没声明。
先看悬停提示，再决定是加 typing.Union、补 -> None 返回注解，还是加 # type: ignore。盲目关检查，后面 debug 时反而更费时间。
