修复pyinstaller打包失败的问题

2026-05-20 19:41:31 +08:00
parent d36618d101
commit 150486a29b
2 changed files with 151 additions and 57 deletions
--- a/README.md
+++ b/README.md
@@ -368,6 +368,99 @@ exe = EXE(
 )
 ```

+**完整 spec 文件示例（`myapp.spec`）：**
+
+```python
+# -*- mode: python ; coding: utf-8 -*-
+
+block_cipher = None
+
+a = Analysis(
+    ['src\\main.py'],           # 入口脚本
+    pathex=[],
+    binaries=[],
+    datas=[
+        ('assets', 'assets'),   # 额外资源目录：源路径, 目标路径
+    ],
+    hiddenimports=[],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    win_no_prefer_redirects=False,
+    win_private_assemblies=False,
+    cipher=block_cipher,
+    noarchive=False,
+)
+
+pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.zipfiles,
+    a.datas,
+    [],
+    name='MyApp',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,              # True=控制台程序，False=GUI程序
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    icon='assets\\app.ico',     # 图标文件路径
+    version='version_info.txt', # Windows 版本信息文件
+)
+```
+
+**配套的 `version_info.txt` 示例：**
+
+```python
+# UTF-8
+# Windows EXE 版本信息文件
+# 版本号格式：major, minor, patch, build（均为整数）
+
+VSVersionInfo(
+    ffi=FixedFileInfo(
+        filevers=(5, 0, 1920, 11),      # FileVersion，对应 FileVersion=5.0.1920.11
+        prodvers=(5, 0, 1920, 11),      # ProductVersion
+        mask=0x3f,
+        flags=0x0,
+        OS=0x40004,
+        fileType=0x1,                   # 0x1=EXE, 0x2=DLL
+        subtype=0x0,
+        date=(0, 0),
+    ),
+    kids=[
+        StringFileInfo([
+            StringTable(
+                '040904B0',             # 语言 0409=英语, 04B0=Unicode
+                [
+                    StringStruct('CompanyName',      'MyCompany'),
+                    StringStruct('FileDescription',  'MyApp Application'),
+                    StringStruct('FileVersion',      '5.0.1920.11'),
+                    StringStruct('InternalName',     'MyApp'),
+                    StringStruct('LegalCopyright',   'Copyright (C) 2026 MyCompany'),
+                    StringStruct('OriginalFilename', 'MyApp.exe'),
+                    StringStruct('ProductName',      'MyApp'),
+                    StringStruct('ProductVersion',   '5.0.1920.11'),
+                ]
+            )
+        ]),
+        VarFileInfo([VarStruct('Translation', [0x0409, 0x04B0])])
+    ]
+)
+```
+
+> `version_info.txt` 中的版本号需与实际构建版本保持一致。如需自动同步，可在构建脚本中先调用 `gitver setver=<pid>` 获取版本，再用脚本替换 `version_info.txt` 中的版本字段，然后执行 `gitver pyinstaller=<pid> params="myapp.spec"`。
+
 ---

 ## 错误码