如何制作可执行Bash文件实现一键启动Dash仪表盘？

一、核心思路 #

把所有相关文件（Python脚本、Excel表格、虚拟环境）放在同一个文件夹下，用相对路径替代硬编码路径，确保不同用户的路径都能适配；针对Mac和Windows分别编写启动脚本，或用跨平台方案统一处理。

二、Mac端修正方案 #

1. 修正后的Bash脚本（start_dashboard.sh） #

#!/bin/bash
# 切换到脚本所在的文件夹
cd "$(dirname "$0")" || exit 1

# 激活同目录下的虚拟环境（假设虚拟环境文件夹名为env）
if [ -d "./env" ]; then
    source ./env/bin/activate
else
    echo "未找到虚拟环境文件夹，请确保env文件夹和脚本在同一目录下"
    read -p "按任意键退出..."
    exit 1
fi

# 启动Dashboard脚本，后台运行
python Dashboard.py &

# 等待服务启动（避免浏览器打开时服务未就绪）
sleep 2

# 打开浏览器访问仪表盘
open http://127.0.0.1:8050

2. 双击启动的优化设置 #

• 给脚本添加可执行权限：终端执行 chmod +x start_dashboard.sh
• 更友好的方式：用Mac自带的Automator制作应用程序
  1. 打开Automator，选择"应用程序"模板
  2. 添加"运行Shell脚本"动作，输入：cd "$(dirname "$0")/../" && ./start_dashboard.sh
  3. 保存为启动仪表盘.app，同事双击即可启动

三、Windows端方案 #

批处理脚本（start_dashboard.bat） #

@echo off
chcp 65001 >nul  # 解决中文乱码问题
:: 切换到脚本所在的文件夹
cd /d "%~dp0"

:: 激活同目录下的虚拟环境
if exist "env\Scripts\activate.bat" (
    call env\Scripts\activate.bat
) else (
    echo 未找到虚拟环境文件夹，请确保env文件夹和脚本在同一目录下
    pause
    exit /b 1
)

:: 启动Dashboard脚本（后台运行）
start /B python Dashboard.py

:: 等待服务启动
timeout /t 2 /nobreak >nul

:: 打开浏览器访问仪表盘
start http://127.0.0.1:8050

同事只需双击这个.bat文件即可启动，无需手动打开终端。

四、跨平台统一方案（Python启动脚本） #

如果同事电脑已安装Python，可编写start.py自动适配系统：

import os
import platform
import subprocess
import time
import webbrowser

# 切换到脚本所在目录
script_dir = os.path.dirname(os.path.abspath(__file__))
os.chdir(script_dir)

# 根据系统执行对应操作
system = platform.system()
if system == "Darwin":  # Mac系统
    activate_path = os.path.join(script_dir, "env", "bin", "activate")
    subprocess.run(f"source {activate_path} && python Dashboard.py", shell=True, start_new_session=True)
elif system == "Windows":  # Windows系统
    activate_path = os.path.join(script_dir, "env", "Scripts", "activate.bat")
    subprocess.run(f'cmd /c "{activate_path} && python Dashboard.py"', shell=True, start_new_session=True)
else:
    print("不支持当前操作系统")
    input("按任意键退出...")
    exit()

# 等待服务启动后打开浏览器
time.sleep(2)
webbrowser.open("http://127.0.0.1:8050")

同事双击start.py即可启动，无需额外操作。

五、注意事项 #

• 所有相关文件（Python脚本、Excel表格、虚拟环境env）必须放在同一文件夹，避免路径错误
• 若不想依赖虚拟环境，可提前导出依赖清单：终端执行pip freeze > requirements.txt，让同事运行pip install -r requirements.txt安装依赖
• 检查Dash脚本的监听地址是否为127.0.0.1，避免使用错误的IP地址

内容的提问来源于stack exchange，提问作者Mic Merian