跳转至

Python Packaging Tools

PyInstaller

PyInstaller 是一个用于将 Python 应用程序打包为可执行文件的工具。 它可以将 Python 代码打包为独立的可执行文件,支持 Windows、Linux 和 macOS 平台。

基本用法

# 最简单的打包命令
pyinstaller your_script.py

# 打包成单个文件
pyinstaller --onefile your_script.py

# GUI程序打包(不显示控制台)
pyinstaller --onefile --windowed your_script.py

常用参数

  • -onefile: 打包成单个可执行文件
  • -windowed: 不显示控制台窗口
  • -icon=app.ico: 指定应用图标
  • -name=应用名: 指定输出文件名
  • -add-data="文件路径;目标路径": 添加额外文件
  • -hidden-import=模块名: 添加隐式导入的模块

打包后的文件结构

dist/
    - your_script.exe    # Windows下的可执行文件
build/                   # 构建过程的临时文件
your_script.spec         # 打包配置文件

注意事项

  • 在哪个系统打包就只能在哪个系统运行
  • 确保所有依赖都已正确安装
  • 打包后的文件体积会比较大
  • 需要注意资源文件的路径处理