Python 打包 EXE 极简指南

3 分钟搞定,零废话,直接上手;先看效果

一、为什么需要打包?

同事电脑没装 Python?客户看不懂命令行?一个 .exe 文件,双击就能跑,告别"在我电脑上明明是好的"。

二、安装工具

一行命令搞定:

Bash 复制代码
pip install pyinstaller

验证是否成功:

Bash 复制代码
pyinstaller --version

三、核心命令(记这 3 个就够了)

场景 命令
最简打包(文件夹形式) pyinstaller main.py
单文件(推荐) pyinstaller -F main.py
GUI 程序无黑窗 pyinstaller -F -w main.py
加图标 pyinstaller -F -w -i app.ico main.py

四、打包后文件在哪?

命令跑完后,打开项目目录:

Plain 复制代码
你的项目/
├── dist/          ← 可执行文件在这里
│   └── main.exe   ← 就是它
├── build/         ← 临时文件,可删
└── main.spec      ← 配置文件,高级玩法用

五、GUI 程序必看:资源文件怎么带?

如果你的程序要读取 config.json 或图片,单文件模式下路径会失效。复制下面这段代码到项目里:

Python 复制代码
import sys, os

def resource_path(relative_path):
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

# 使用
config = resource_path("config.json")

打包命令加上数据文件:

Bash 复制代码
pyinstaller -F --add-data "config.json;." main.py

六、常见问题速查

问题 解决
文件体积太大(几百 MB) 用 虚拟环境 打包,只装必要依赖
运行报错 ModuleNotFoundError pyinstaller --hidden-import=模块名 main.py
杀毒软件误报 升级 PyInstaller 到最新版
图标没生效 必须是 .ico 格式,用在线转换工具转一下

七、不想敲命令?

装个图形化工具,点鼠标就行:

Bash 复制代码
pip install auto-py-to-exe
auto-py-to-exe

自动打开配置页,勾选参数一键打包。

总结

  1. 装:pip install pyinstaller
  2. 打:pyinstaller -F -w main.py
  3. 拿:去 dist 文件夹取 exe

搞定。

💬 你打包时遇到过什么奇葩报错?评论区聊聊,一起排查。

相关推荐
SimonKing6 小时前
AI Assistant被"隐藏"了?别慌,IDEA 2026.3 这波是换了个脑子
java·后端·程序员
codigger7 小时前
用户连点两次「确认支付」,你的后端凭什么只扣一次钱?
java·程序员·支付·java后端
深蓝AI12 小时前
12000 名工程师的高盛,只用四个月就收回了交易员的 AI 编程权限
人工智能·程序员
深蓝AI19 小时前
为什么 agent 的 demo 都很惊艳,上了生产就不靠谱
人工智能·程序员
深蓝AI19 小时前
一个项目五个 AI 同时干活,Claude Code 怎么让它们不互相打架
人工智能·程序员
程序员cxuan3 天前
讲真,智能路由这事儿,还得看基元律动
人工智能·后端·程序员
AI前端工程狮3 天前
用户点了「取消」,我的服务进程退出了
人工智能·程序员
得物技术3 天前
压测AI Agent 治理与评测调优实践
程序员·架构·测试
SimonKing3 天前
Workbuddy太占C盘空间了,写个迁移工具迁走10G的数据
java·后端·程序员
挖掘狂人3 天前
Token 都上双十一货架了,AI 电脑的账该怎么算?
大数据·程序员·ai编程