QGIS插件仓库上传新版本遇插件包解压失败报错求助

• 检查压缩包格式与结构

  • 必须使用标准ZIP格式压缩，禁止用RAR、7z等其他格式，QGIS插件仓库仅支持ZIP解压。
  • 压缩包内不能嵌套多余文件夹：打开ZIP后需直接看到metadata.txt、my_plugin.py等核心文件，而非先进入一个插件名称的文件夹再看到这些内容。

• 清理非必需文件

  • 移除开发辅助文件：compile.bat、自定义批处理文本文件、plugin_upload.py、pb_tool.cfg、Makefile、pylintrc这些都是本地开发用的，不需要打包上传。
  • 删除临时索引文件：my_plugin_help.chw是CHM帮助文件的临时索引，无需包含在压缩包内，只保留my_plugin_help.chm即可。
  • 确认仅保留编译后的资源文件：resources.py是resources.qrc编译后的结果，上传时可以移除resources.qrc源文件，避免冗余。

• 检查文件命名与权限

  • 所有文件名、文件夹名必须用英文、数字或下划线，禁止中文、空格及特殊符号（如!@#），防止解压时出现编码错误。
  • 确保所有文件无加密、只读等特殊权限，压缩时要包含完整的文件读写权限。

• 重新生成压缩包

  • 使用系统自带压缩工具打包（Windows右键→发送到→压缩(zipped)文件夹），不要用第三方压缩软件的特殊选项（如加密、高压缩率模式）。
  • 仅选中插件核心文件和文件夹打包：i18n/、About.ui、Dialog.ui、Helpfile.ui、icon.png、metadata.txt、my_plugin.py、my_plugin_dockwidget.py、my_plugin_dockwidget_base.ui、requirements.txt、resources.py、my_plugin_help.chm。

• 验证压缩包可用性

  • 手动解压自己生成的ZIP包到本地，确认无解压报错，文件结构正确。
  • 打开QGIS，通过「插件管理器→安装来自ZIP的插件」加载这个压缩包，验证插件能正常启动，排除文件损坏问题。

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