本文记录了将 start.bat 打包成 .exe 启动器的详细教程，适合项目交付或导师演示用。

---

🧭 一、如何将 start.bat 打包为启动器 .exe（含图标 + 自动打开浏览器）

✅ 1. 创建三大功能脚本

start.bat      → 启动项目（docker compose up -d）
build.bat      → 构建镜像（docker compose build）
restart.bat    → 重置数据库并重启（docker compose down -v） 

🔧 这三个脚本要放在你项目根目录，便于后续统一调用。

---

✅ 2. 写一个启动器界面：launcher.py

使用 Python 的 tkinter 创建一个简单图形界面：

import tkinter as tk
import subprocess
import webbrowser

def run_script(script_name):
    try:
        subprocess.Popen([script_name], shell=True)
        if script_name == "start.bat":
            webbrowser.open("http://localhost:8080")
    except Exception as e:
        print(f"Error running {script_name}: {e}")

win = tk.Tk()
win.title("RuoYi Docker 启动器")
win.geometry("300x200")
win.resizable(False, False)

tk.Label(win, text="请选择操作", font=("微软雅黑", 12)).pack(pady=15)
tk.Button(win, text="✅ 快速启动项目", width=30, command=lambda: run_script("start.bat")).pack(pady=5)
tk.Button(win, text="🛠 构建镜像", width=30, command=lambda: run_script("build.bat")).pack(pady=5)
tk.Button(win, text="🔄 重置并重建环境", width=30, command=lambda: run_script("restart.bat")).pack(pady=5)

win.mainloop()

 

保存为 launcher.py 

✅ 3. 准备 .ico 图标文件

你可以从 icoconverter.com

上传一张 PNG 图片，转换为 .ico 图标，保存为：

ruoyi.ico

 (我设置的visual.ico)

放在和 launcher.py 同一个目录下。

✅ 4. 使用 PyInstaller 打包为 .exe

打开命令行，切换到 launcher.py 所在目录，执行：

pip install pyinstaller
pyinstaller --noconfirm --onefile --noconsole --icon=ruoyi.ico launcher.py

你将得到：

dist/launcher.exe     ← 可直接分发使用

 （我已改名visual.exe）

✅ 无黑框、图标已设置、点击后可弹窗选择并执行 .bat 脚本。

📦 5. 推荐打包目录结构

RuoYi-Docker-Starter/
├── launcher.exe
├── start.bat
├── build.bat
├── restart.bat
├── docker-compose.yml
├── backend/
├── frontend/

📤 打包建议

将该目录压缩为 RuoYi-Docker-Starter.zip，发送给其他人直接解压即可使用。

注意： 图中多出来的文件我没有删除（用笔划掉的都可以删），要将dist里面的launcher.exe剪切到根目录

 

⚠️ 注意事项

• 所有 .bat 文件必须与 .exe 在同一目录；

• 不要把路径设为中文或有空格（易报错）；

• 对方电脑必须安装了 Docker 与 Docker Compose；

• .ico 文件建议 256x256 像素以内，不能太大。