如何在PyCharm中全局忽略特定变量gl的“Unresolved Reference”错误？

方案一：全局添加未解析引用忽略规则 #

• 打开PyCharm设置（快捷键Ctrl+Alt+S，或通过File > Settings进入）
• 依次展开Editor > Inspections > Python，找到Unresolved reference检查项
• 在右侧面板的Ignore references输入框中输入gl
• 确认顶部的Scope下拉选项选择的是整个项目（比如显示为你的项目名称或"Project"）
• 点击Apply和OK保存设置，所有文件中的gl引用错误都会被忽略

方案二：创建全局存根文件让PyCharm识别变量 #

• 在项目根目录新建一个名为globals.pyi的文件（.pyi是Python存根文件的后缀）
• 在文件中写入以下内容（可根据gl的实际类型调整）：

# 定义全局变量gl，可指定类型
gl = None

• 确保该文件未被PyCharm排除在项目之外（右键文件 > Mark Directory as > 不要选Excluded）
  PyCharm会自动读取这个存根文件，将gl识别为全局存在的变量，不再报错

方案三：利用项目包的__init__.py声明全局变量 #

如果你的项目是Python包结构（根目录有__init__.py）：

• 在根目录的__init__.py中添加gl = None（或实际的初始化代码）
• 在需要使用gl的文件顶部添加导入语句：from your_project_name import gl
  这样PyCharm会通过导入识别到gl的存在，同时不影响自定义解释器的运行逻辑

内容的提问来源于stack exchange，提问作者Kfir Ettinger