本文記錄了將
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 webbrowserdef 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 像素以內,不能太大。
?
?