宝藏级教程：把你的 Python 脚本打包成 exe，拿给同事用直接秀翻全场！

菜鸟程序员晓鹤

1788人浏览 · 2025-09-15 11:23:55

菜鸟程序员晓鹤 · 2025-09-15 11:23:55 发布

前言：为什么我们需要打包？

相信很多用 Python 写小工具的同学都遇到过这样的窘境：

你用 Python 写了一个自动化处理文件的小脚本，自己用着很爽。当你想分享给同事用时，却发现困难重重：

“啥？我电脑上没装 Python？”

“什么是 pip？还要装依赖库？”

“双击怎么没反应？还要用命令行打开？”

这一系列问题直接劝退了 99% 的非技术用户。而 PyInstaller 就是解决这个问题的终极神器！它能将你的 .py 脚本连同所有依赖项，一起打包成一个独立的 .exe 可执行文件。用户只需要双击运行，无需安装任何环境，体验和普通软件一模一样！

本文将从入门到进阶，带你彻底掌握 PyInstaller 的使用方法。

文章目录

前言：为什么我们需要打包？

文章目录

一、准备工作：安装 PyInstaller

二、牛刀小试：最基础的打包命令

三、进阶用法：掌握这些参数，打包更专业！

1. --onefile 或 -F：打包成单文件

2. --windowed 或 -w：隐藏控制台黑窗口

3. --icon=<图标路径> 或 -i <图标路径>：设置程序图标

4. --distpath 和 --workpath：指定输出路径

四、实战演练：打包我们的文件重命名工具

五、常见问题（踩坑指南）

总结

一、准备工作：安装 PyInstaller

首先，你需要确保你的电脑已经安装了 Python 和 pip。然后，打开你的终端（CMD 或 PowerShell），一行命令即可完成安装：

pip install pyinstaller

安装成功后，你就可以在命令行中使用 pyinstaller 命令了。

二、牛刀小试：最基础的打包命令

我们从最简单的命令开始。假如你有一个脚本叫 hello.py。

打开终端，cd 到 hello.py 所在的文件夹。
执行以下命令：
```
pyinstaller hello.py
```

等待命令执行完毕后，你会发现当前目录下多了几个文件夹：

build/: 存放打包过程中产生的临时文件，可以删除。
dist/: 存放最终成品的文件夹！ 你的 hello.exe 就在里面。
hello.spec: 一个配置文件，告诉 PyInstaller 如何打包，高级用法会用到它。

现在，进入 dist 文件夹，你会发现里面除了 hello.exe 还有一大堆其他文件。这是因为默认模式是“文件夹模式”。双击 hello.exe 就能运行，但分发时需要把整个 dist 文件夹发给别人。这显然不够优雅！

三、进阶用法：掌握这些参数，打包更专业！

为了解决上面的问题，我们需要给 pyinstaller 命令加上一些参数。下面是最常用的几个“必杀技”参数：

1. --onefile 或 -F：打包成单文件

这是最重要的参数！它会将所有依赖项全部打包进一个独立的 .exe 文件中。

pyinstaller --onefile hello.py

或者使用缩写：

pyinstaller -F hello.py

执行完毕后，dist 文件夹里就只有一个干干净净的 hello.exe 了，这才是我们想要的样子！

注意：单文件模式启动时会慢一点，因为它需要先在临时目录解压自身再运行。但这点牺牲换来便捷性是完全值得的。

2. --windowed 或 -w：隐藏控制台黑窗口

如果你打包的是一个带有图形界面（如 Tkinter, PyQt）的程序，你一定不希望运行时背后还跟着一个黑色的命令行窗口。这个参数就是为你准备的。

# 假设 my_app.py 是一个 GUI 程序
pyinstaller -F -w my_app.py

警告：如果你的程序是纯命令行的，千万不要加 -w 参数！否则程序会在后台静默运行，你看不到任何输出，也无法结束它。

3. --icon=<图标路径> 或 -i <图标路径>：设置程序图标

想让你的程序有一个酷炫的图标，而不是默认的样式？用 -i 参数。

你需要准备一个 .ico 格式的图标文件。网上有很多在线工具可以把 .png 或 .jpg 转换成 .ico。

pyinstaller -F -w -i "D:\icons\my_icon.ico" my_app.py

4. --distpath 和 --workpath：指定输出路径

默认情况下，dist 和 build 文件夹会创建在当前目录下，显得很乱。我们可以用下面两个参数来指定它们的生成路径，保持源码目录的整洁。

--distpath: 指定最终 .exe 文件的输出目录。
--workpath: 指定编译过程中的临时文件目录。

# 将最终的 exe 输出到桌面上的 "MyApp" 文件夹
# 将临时文件放在当前目录下的 "temp_build" 文件夹
pyinstaller -F -w -i my_icon.ico --distpath "%USERPROFILE%\Desktop\MyApp" --workpath "temp_build" my_app.py

四、实战演练：打包我们的文件重命名工具

现在，我们来打包上一篇文章中那个功能强大的文件重命名工具（file_tool_pro.py）。

我们的目标是：

打包成单个文件。
它有 GUI 界面，所以需要隐藏控制台。
给它一个自定义图标。
将成品输出到桌面。

最终的命令如下：

pyinstaller --onefile --windowed --icon="my_tool_icon.ico" --distpath="%USERPROFILE%\Desktop\MyTools" file_tool_pro.py

执行这条命令，稍等片刻，一个专业、独立的桌面工具就诞生在你的桌面上啦！

五、常见问题（踩坑指南）

打包的 exe 文件太大怎么办？
- 强烈建议：为你的项目创建一个独立的 Python 虚拟环境，只安装项目必需的库。这样 PyInstaller 就不会把全局环境中多余的库打包进去，体积会小很多。
杀毒软件误报病毒？
- 这是 PyInstaller 的老问题了。因为 exe 在启动时会解压，这种行为和某些恶意软件相似，容易引起杀毒软件的误判。解决方法是尝试升级 PyInstaller (pip install --upgrade pyinstaller)，或者将你的程序添加到杀毒软件的信任区。
程序依赖了外部文件（如配置文件、图片）怎么办？
- 对于这种情况，你需要使用 .spec 配置文件中的 datas 选项，或者使用 --add-data 参数来告诉 PyInstaller 这些外部文件的存在。这是一个更高级的话题，可以另开一篇文章详谈。