在 TRAE 中将 py 文件打包为可执行文件

一、为什么要打包成 exe

你写好的 .py 文件，在别人电脑上不一定能直接运行： 对方必须也装了 Python，还要用对版本、用对方式打开。打包就是把程序和它所依赖的 Python 环境一起装进一个文件， 变成一个双击就能用的可执行程序（Windows 上是 .exe）。

一句话理解：打包相当于把你的程序连同 Python 一起打包带走， 代价就是体积变大、启动稍微慢一点。

二、准备工作：Python、pip 和 PyInstaller

打包需要三样东西就位：Python（已经装好了）、pip（跟着 Python 一起装上的包管理工具）、 PyInstaller（专门负责打包的第三方库）。

1. 在 TRAE 里打开终端

按 Ctrl 加键盘左上角 Esc 下面的反引号键，底部会弹出一块终端； 也可以在菜单里点 终端 → 新建终端。后面所有命令都在这里敲。

2. 确认 Python 装好了

python --version

出现版本号就说明没问题。3. 后面是你的小版本号， 你电脑上具体是哪个，都不影响后面的操作：

Python 3.<小版本号>

3. 安装 PyInstaller

pip 是 Python 自带的安装工具，用它装 PyInstaller 只要一条命令：

pip install pyinstaller

终端里会刷出几行安装信息，最后一行以 Successfully installed 开头，就说明装好了。 想再确认一次，可以敲 pyinstaller --version，能打印出版本号（例如 6.<小版本号>）就对了。

三、让 TRAE 自动打包

不想记命令也行，TRAE 的 AI 可以直接帮你搞定。它有两种方式。

方式 A：行内对话（Ctrl + I）

1. 把光标放在要打包的 .py 文件里；
2. 按 Ctrl + I；
3. 输入 「把这个文件打包成单个 exe 文件」；
4. AI 会给出打包命令，有的版本还能直接帮你执行。

方式 B：侧边对话（Ctrl + U）

1. 先把文件添加到对话（选中代码 → 点「添加到对话」）；
2. 在侧边对话框里输入 「帮我把这个程序用 PyInstaller 打包成单个 exe，并说明每条参数的意思」；
3. AI 会给出命令，还会解释 --onefile、--windowed 各是什么意思。

四、手动执行打包命令

命令其实很简单，会一条就够用。假设我们的程序 hello.py 是这么一个小程序（帮同学算奶茶钱）：

# 帮同学算奶茶钱：每杯 12 元，一共买 2 杯，另加 3 元打包费
price = 12
cups = 2
total = price * cups + 3
print(f"{cups} 杯奶茶一共 {total} 元")

先用 Python 跑一遍，确认程序本身没问题，输出是：

2 杯奶茶一共 27 元

然后回到终端，先进入文件所在的文件夹，再执行打包命令：

cd C:\你的练习文件夹\python_study
pyinstaller --onefile hello.py

终端会刷出一大串 INFO 开头的日志，这是正常的。 看到最后出现 Building EXE ... completed successfully，就说明打包成功了。

换个名字、加个图标

参数可以叠着用。下面这条把程序名改成「奶茶计算器」，并给它指定一个图标：

pyinstaller --onefile --name 奶茶计算器 --icon=myicon.ico hello.py

这条命令的意思是：打成单个文件、名字叫「奶茶计算器」、用 myicon.ico 当图标。

五、打包结果在哪里找

打包完后，你的文件夹会多出三样东西：

python_study/
├─ hello.py          ← 你写的源文件，还在
├─ dist/
│  └─ hello.exe      ← 要发给别人的成品
├─ build/
└─ hello.spec

六、常用打包参数一览

常用的就下面这几个，用不到的不必记。

七、把程序发给别人

1. 只发 dist 里的成品：用 --onefile 打包时，就是 dist 里那一个 exe； 没加这个参数时，dist 里是一个文件夹，要整个文件夹一起发。
2. 对方不用装 Python：这正是打包的意义。
3. 系统要对得上：Windows 上打的包只能在 Windows 上跑，macOS 上打的包只能在 macOS 上跑。
4. 体积大是正常的：几十 MB 很正常，因为 Python 解释器被一起装进去了。

八、打包常见报错与排查

打包本身很少出错，出问题大多卡在下面这几处。

九、常见问题

• 打包一次要多久：第一次比较慢（几十秒到一两分钟），之后会快很多，属正常。
• build 目录和 .spec 文件能不能删：能。它们只是中间产物，dist 里的成品别删。
• 能不能在 Mac 上打出 Windows 用的包：不能直接打。打包出来的程序只认同一种系统； 要给 Windows 用户，就在 Windows 电脑上打包。
• 同学收到 exe 打不开：常见三个原因——杀毒软件拦截、系统版本差太多、 或者你用了默认模式（打成文件夹）却只发了里面的 exe。先确认发的是完整的成品。
• 改完程序怎么办：改完 .py、存盘，再执行一次打包命令， 用 dist 里新生成的文件覆盖旧的就行。
• 打包报错看不懂：把报错的最后一行复制给 TRAE 的 AI（Ctrl + U）， 它能告诉你缺什么、该补哪一步。

十、随堂自测（12 题）

点击选项即可判分，答错的题会立刻显示解析。全部答完后会给出正确率和错题清单。