### macOS 上使用 PyInstaller 的指南 在 macOS 系统上，PyInstaller 提供了一种便捷的方式将 Python 脚本打包为可执行文件。以下是关于如何配置和使用的详细说明。 #### 安装 PyInstaller 为了能够在 macOS 上使用 PyInstaller，首先需要确保已正确安装该工具。可以通过以下命令完成安装： ```bash pip install pyinstaller ``` 如果遇到网络问题或者速度较慢的情况，可以尝试使用国内镜像源来加速安装过程[^5]。 #### 基础命令结构 一旦成功安装了 PyInstaller，在终端中可以直接调用 `pyinstaller` 来构建可执行文件。最基础的形式如下所示： ```bash pyinstaller your_script.py ``` 这会创建一个默认的输出目录 `dist/your_script` 和一些中间文件存放在 `build/` 中[^1]。 #### 单一文件模式 对于希望最终产物仅包含单一 `.exe` 文件的需求，可以添加参数 `--onefile` 或 `-F` 实现此目标。例如： ```bash pyinstaller --onefile your_script.py ``` 这样做的好处在于减少分发复杂度并使部署更加简便[^2]。 #### 图形界面优化 (隐藏控制台窗口) 当开发的是 GUI 应用而非基于命令行的应用时，可能不希望启动时显示多余的终端窗口。此时可通过加入选项 `-w` 避免这种情况发生： ```bash pyinstaller --onefile -w your_gui_app.py ``` 注意：这个设置只适用于 Windows 平台上生成 .exe 文件；而在 macOS 下，则不会弹出额外的 Terminal 窗口[^3]。 #### 自定义图标 为了让生成的应用更具有识别性，还可以指定自定义图标代替默认图标。假设有一个名为 `logo.icns` 的 Mac OS X 特定格式图标文件位于当前工作路径下，则可以用下面这种方式设定它作为应用图标的资源链接： ```bash pyinstaller --onefile -w -i logo.icns your_gui_app.py ``` 请注意，这里我们用了 `.icns` 格式的图片因为这是适合于 macOS 的标准图标格式[^5]。 #### 复杂场景下的高级特性 除了上述基本功能外，PyInstaller 还提供了许多其他有用的功能，比如隐含导入模块的支持、数据文件嵌入等。这些都可以通过查阅官方文档进一步学习掌握[^4]。 --- ### 示例代码片段 以下展示了一个简单的例子，演示如何利用 PyInstaller 创建带图形界面的小型计算器程序，并将其转化为独立运行版本。 ```python import tkinter as tk def calculate(): result.set(float(entry_a.get()) + float(entry_b.get())) root = tk.Tk() result = tk.StringVar() label_a = tk.Label(root, text="Value A:") entry_a = tk.Entry(root) plus_sign = tk.Label(root, text="+") label_b = tk.Label(root, text="Value B:") entry_b = tk.Entry(root) button_calculate = tk.Button(root, text="Calculate", command=calculate) output_label = tk.Label(root, textvariable=result) widgets = [label_a, entry_a, plus_sign, label_b, entry_b, button_calculate, output_label] for widget in widgets: widget.pack() tk.mainloop() ``` 保存以上脚本到本地磁盘上的某个位置（如 `/Users/user/calculator.py`），然后打开终端进入相同目录执行下列指令即可得到单独的 exe 文件： ```bash pyinstaller --onefile -w calculator.py ``` 完成后会在同一级目录找到新建立起来的 dist 子文件夹里面存放着我们的成品！ --- 相关问题