Python 转 EXE (实用工具)

Python 转 EXE 完整指南(PyInstaller)

**注意:**只能在 Windows 系统打包出 Windows 的 exe;Mac 只能打包 mac 程序,不能跨系统编译。

一、安装 PyInstaller

打开 cmd / PowerShell,执行:

bash 复制代码
pip install pyinstaller

多 Python 版本环境下,使用:

bash 复制代码
py -3 -m pip install pyinstaller

二、进入 py 文件目录

bash 复制代码
# 示例,换成你自己的文件夹路径
cd D:\code\demo

三、打包命令(最常用)

3.1 基础打包命令

bash 复制代码
pyinstaller -F test.py
bash 复制代码
pyinstaller -F -w test.py
bash 复制代码
pyinstaller -F -w -i app.ico test.py

3.2 参数说明

参数 说明
-F 打包成单个独立 exe 文件(推荐,方便发给别人);不带 -F 会生成一堆依赖文件夹
-w 运行时隐藏黑色控制台窗口(GUI 程序才加,print 打印的程序不要加)
-i xxx.ico 设置 exe 图标
-n myapp 自定义 exe 名称
--add-data 附带图片/配置等静态资源(Windows 用分号 ; 分隔)

四、打包完成后的产物

打包成功后,目录会生成 3 个东西:

  • build/:临时打包缓存(可删除)

  • dist/ :exe 在这里!

  • xxx.spec:打包配置文件(可删除)

直接去 dist 文件夹拿 exe,发给没有装 Python 的 Windows 电脑也能运行。

五、资源文件(图片、json、csv)打包重点

假设你有 config.json,需要打包进 exe:

bash 复制代码
pyinstaller -F --add-data "config.json;." test.py

代码里读取资源路径要兼容打包:

python 复制代码
import sys, os

def get_resource_path(relative_path):
    if hasattr(sys, '_MEIPASS'):
        base_path = sys._MEIPASS
    else:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 使用
file_path = get_resource_path("config.json")

六、常见坑

  1. pyinstaller 不是内部命令 :把 Python 的 Scripts 目录加到环境变量,或者用 python -m PyInstaller test.py

  2. exe 体积很大:正常,内置 Python 解释器;可以用虚拟环境只装必要包来减小体积

  3. 双击 exe 一闪而过 :不要加 -w,或者在代码末尾加 input() 暂停看报错

  4. 杀毒软件误报:PyInstaller 打包文件经常被 Windows Defender 报毒,属于误报

七、可视化工具:auto-py-to-exe

不想敲命令可以用图形界面版,底层还是 PyInstaller:

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

会打开网页窗口,点选配置一键打包。

相关推荐
黑客笔记17 小时前
python小工具win7翻车事故现场
python
pps-key18 小时前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
汤姆宝库19 小时前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
岁月宁静19 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
benchmark_cc19 小时前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
ZhengEnCi20 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
驭渊的小故事20 小时前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Dmz丶21 小时前
前端转 AI 100 天 Day 45:阶段复盘——从“会调 API”到“做出 AI 产品”
python
Sakura_j_h_21 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
微笑星河q21 小时前
C++STL【vector】常用接口函数使用和迭代器失效问题
开发语言·c++