由 URL采集专家 
PyInstaller 是一个用于将 Python 程序打包成独立可执行文件的工具。以下是 PyInstaller 的详细参数说明：
基本用法
常用参数分类
1. 生成选项
| 参数 | 说明 |
|---|---|
-D, --onedir |
创建一个包含可执行文件的文件夹（默认） |
-F, --onefile |
创建一个单独的可执行文件 |
--specpath DIR |
指定 .spec 文件的存储目录 |
-n NAME, --name NAME |
指定项目名称 |
--distpath DIR |
指定生成文件的输出目录 |
--workpath DIR |
指定临时工作目录 |
2. 要包含的内容
| 参数 | 说明 |
|---|---|
--add-data SRC;DEST |
添加额外的文件（Windows 用 ; 分隔，Linux/Mac 用 : 分隔） |
--add-binary SRC;DEST |
添加额外的二进制文件 |
-p DIR, --paths DIR |
添加模块搜索路径 |
--hidden-import MODULE |
添加隐藏导入的模块 |
--collect-all MODULE |
收集指定模块的所有子模块和资源 |
--copy-metadata PACKAGE |
复制包的元数据 |
3. 生成模式
| 参数 | 说明 |
|---|---|
-d, --debug |
生成调试版本 |
-s, --strip |
对可执行文件进行 strip 操作（移除调试符号） |
--noupx |
不使用 UPX 压缩 |
--upx-exclude FILE |
排除指定的文件不被 UPX 压缩 |
4. Windows 特定选项
| 参数 | 说明 |
|---|---|
-c, --console, --nowindowed |
打开控制台窗口（默认） |
-w, --windowed, --noconsole |
不打开控制台窗口 |
--icon ICON.ico |
指定程序图标 |
--version-file FILE |
添加版本资源文件 |
--manifest FILE |
添加清单文件 |
--uac-admin |
请求管理员权限 |
--uac-uiaccess |
允许提升权限的应用程序与桌面交互 |
5. Mac 特定选项
| 参数 | 说明 |
|---|---|
--icon ICON.icns |
指定程序图标 |
--bundle-id ID |
设置 bundle identifier |
6. 其他选项
| 参数 | 说明 |
|---|---|
--clean |
清理 PyInstaller 缓存并移除临时文件 |
--log-level LEVEL |
设置日志级别（DEBUG, INFO, WARN, ERROR, CRITICAL） |
-y, --noconfirm |
替换输出目录时不确认 |
--runtime-tmpdir PATH |
指定运行时的临时目录 |
-h, --help |
显示帮助信息 |
-v, --version |
显示版本信息 |