Python代码打包为EXE最新指南

# 建议使用干净的虚拟环境
python -m venv pack-env
# Windows
pack-env\Scripts\activate
# macOS/Linux
source pack-env/bin/activate

# 安装最新版（2026 年建议 ≥ 6.0）
pip install --upgrade pyinstaller

# main.py
import sys
import tkinter as tk
from tkinter import messagebox

def main():
    root = tk.Tk()
    root.title("我的第一个打包程序")
    root.geometry("400x300")

    label = tk.Label(root, text="Hello from EXE!", font=("微软雅黑", 16))
    label.pack(pady=50)

    btn = tk.Button(root, text="点我", command=lambda: messagebox.showinfo("提示", "打包成功！"))
    btn.pack()

    root.mainloop()

if __name__ == "__main__":
    main()

# 单文件模式（推荐给新手）
pyinstaller -F main.py

# 常用参数组合（强烈推荐）
pyinstaller -F \
    --noconfirm \
    --clean \
    --windowed \              # 无控制台窗口（GUI程序必加）
    --icon=app.ico \          # 可选：自定义图标
    --name=MyNoteApp \        # exe 文件名
    --add-data "data;data" \  # 如果有资源文件夹（注意分号是 Windows 用，Linux/macOS 用冒号）
    main.py

dist/
└── MyNoteApp.exe     ← 这就是最终的 exe

# myapp.spec
# 运行一次 pyinstaller main.py 后会自动生成 .spec 文件，修改后用下面命令重新打包：
# pyinstaller myapp.spec

block_cipher = None

a = Analysis(
    ['main.py'],
    pathex=[],
    binaries=[],
    datas=[('images/*', 'images'), ('config.yaml', '.')],
    hiddenimports=['PIL._tkinter_finder'],  # tkinter + pillow 常见补丁
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=['torch', 'tensorflow'],       # 排除掉不需要的重量级库
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
)

pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.zipfiles,
    a.datas,
    [],
    name='我的记事本',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,                    # 需要先安装 UPX
    console=False,               # GUI 程序设为 False
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
    icon='app.ico',
)

pip install nuitka

# 最常用命令（单文件 + 优化）
python -m nuitka \
    --standalone \
    --onefile \
    --windows-disable-console \
    --include-package-data=tkinter \
    --windows-icon-from-ico=app.ico \
    --output-dir=dist \
    main.py