Python脚本生成exe的实用指南

2026-04-21 09:20:34 作者：今晚务必早点睡

本文介绍了使用PyInstaller将Python脚本打包成.exe文件的简单方法,并提供了从准备工作到具体命令的一系列指导,包括如何安装PyInstaller、基础打包命令、修改输出目录、改变.exe文件名、隐藏黑窗口等实用技巧,需要的朋友可以参考下

在日常工作中，我们经常会遇到这样的需求：

写了一个 Python 脚本，想给同事用
对方电脑没有 Python 环境
不想教对方装 Python、装依赖
希望直接给一个 .exe，双击就能跑

这篇文章不讲复杂原理、不搞工程化配置，只讲“怎么最简单地把 Python 脚本打成 exe”。

一、先说结论：用 PyInstaller 就够了

目前最简单、最成熟、使用最多的方案是 PyInstaller。

它的特点是：

使用简单
命令直观
对新手友好
适合内部工具、小脚本、自动化程序

本文所有示例，全部基于 PyInstaller。

二、准备工作（只做一次）

确保你有 Python 环境（Windows）

在命令行中执行：

python --version

如果能看到版本号，说明 Python 已安装。

安装 PyInstaller

pip install pyinstaller

安装完成后验证：

pyinstaller --version

三、最简单的打包方式（一条命令）

假设你的脚本文件是：

main.py

最基础的打包命令

pyinstaller -F main.py

解释：

-F：打包成单个 exe 文件
main.py：你要打包的脚本

打包完成后，会生成：

dist/main.exe

拿走 main.exe 就可以使用了。

四、打包后你会看到哪些文件？（不用慌）

第一次打包时，当前目录会出现：

build/
dist/
main.spec

你只需要关心：

dist/main.exe

其他文件：

build/：中间构建文件
*.spec：配置文件（简单打包可以忽略）

五、一个更实用的打包命令（推荐）

在实际使用中，很多人不想每次去 dist/ 目录里找 exe。

先cd到脚本同级目录下：

pyinstaller --onefile --distpath D:\release main.py

这条命令是做什么的？

一句话说明：

把 main.py 打包成一个 exe，并直接输出到 D:\release 目录

打包完成后：

D:\release\main.exe

参数解释（非常简单）

--onefile

等价于 -F
表示打包成一个 exe 文件

--distpath D:\release

main.py

要打包的 Python 脚本

为什么这个命令很实用？

打完包，exe 直接就能拿走
不用关心 dist/、build/
非常适合内网、脚本化、一次性交付

六、改个 exe 名字（很常见）

如果你不想生成 main.exe，可以这样：

pyinstaller -F -n MyTool main.py

生成：

dist/MyTool.exe

配合 --distpath：

pyinstaller -F -n MyTool --distpath D:\release main.py

七、不想弹黑窗口（可选）

如果你的脚本是：

GUI 程序（Tkinter / PyQt）
自动化脚本
不需要命令行输出

可以隐藏黑窗口：

pyinstaller -F -w main.py

说明：

-w / --noconsole：不显示控制台窗口

如果你的脚本靠 print() 看日志，不建议加 -w。