QGIS 3.22.14与PyCharm集成时QT引用缺失问题求助

问题背景 #

试过很多方案都没解决，之前用QGIS 3.16能在PyCharm正常运行，现在升级到3.22.14后遇到QT引用缺失的问题。

系统环境 #

• Windows 10
• QGIS 3.22.14
• PyCharm 2022.3.1 CE

当前使用的启动批处理 #

SET QGISNAME=qgis-ltr
SET QGIS=%OSGEO4W_ROOT%\apps\%QGISNAME%
SET QGIS_PREFIX_PATH=%QGIS%

CALL %OSGEO4W_ROOT%\bin\o4w_env.bat

SET PATH=%PATH%;%QGIS%\bin
path %PATH%;%OSGEO4W_ROOT%\apps\Qt5\bin
path %PATH%;%OSGEO4W_ROOT%\apps\Python39\Scripts

SET PYTHONPATH=%PYTHONPATH%;%QGIS%\python
SET PYTHONHOME=%OSGEO4W_ROOT%\apps\Python39

rem SET QT_PLUGIN_PATH=%OSGEO4W_ROOT%\apps\qt5\plugins

SET PYCHARM="c:\Program Files\JetBrains\PyCharm\bin\pycharm64.exe"

start "PyCharm aware of QGIS" /B %PYCHARM% %*

报错情况 #

已尝试PyCharm“修复IDE”功能，只有把解释器设为python-qgis-ltr.bat时能识别QGIS，但QT引用缺失问题依旧。

解决步骤 #

1. 启用QT插件路径 #

把批处理中被注释的rem SET QT_PLUGIN_PATH=%OSGEO4W_ROOT%\apps\qt5\plugins一行的rem删掉，让QT插件路径生效，这是PyCharm识别QT插件的关键。

2. 调整环境变量加载顺序 #

把CALL %OSGEO4W_ROOT%\bin\o4w_env.bat移到最开头，先加载OSGeo4W的基础环境，再设置QGIS相关路径，避免环境变量被覆盖：

CALL %OSGEO4W_ROOT%\bin\o4w_env.bat

SET QGISNAME=qgis-ltr
SET QGIS=%OSGEO4W_ROOT%\apps\%QGISNAME%
SET QGIS_PREFIX_PATH=%QGIS%

SET PATH=%PATH%;%QGIS%\bin
path %PATH%;%OSGEO4W_ROOT%\apps\Qt5\bin
path %PATH%;%OSGEO4W_ROOT%\apps\Python39\Scripts

SET PYTHONPATH=%PYTHONPATH%;%QGIS%\python
SET PYTHONHOME=%OSGEO4W_ROOT%\apps\Python39

SET QT_PLUGIN_PATH=%OSGEO4W_ROOT%\apps\qt5\plugins

SET PYCHARM="c:\Program Files\JetBrains\PyCharm\bin\pycharm64.exe"

start "PyCharm aware of QGIS" /B %PYCHARM% %*

3. 手动添加QT Python路径到PyCharm #

打开通过批处理启动的PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter：

• 点击右上角齿轮，选择Show All
• 选中当前的python-qgis-ltr.bat解释器，点击Show paths for the selected interpreter
• 添加以下路径（根据你的OSGeo4W安装路径调整）：
  • C:\OSGeo4W\apps\Qt5\python\Qt5
  • C:\OSGeo4W\apps\Qt5\python\Qt5\QtCore
  • C:\OSGeo4W\apps\Qt5\python\Qt5\QtGui
  • 其他报错提示缺失的QT子模块路径

4. 验证环境配置 #

在PyCharm终端中运行以下代码，确认QT模块能正常导入：

import sys
from PyQt5 import QtCore
print(f"QT Core路径: {QtCore.__file__}")
print(f"Python路径: {sys.path}")

如果能正常打印路径，说明配置生效。

内容的提问来源于stack exchange，提问作者The Rabbit