如何自动化分发Python CLI脚本应用？含环境部署全流程需求

一、自动安装指定Python版本 #

• 跨平台工具：pyenv
  针对不同系统编写自动化脚本，实现pyenv的安装及指定Python版本部署：
  • Windows：脚本中先自动安装Chocolatey，再执行choco install pyenv-win，之后运行pyenv install 3.10.12（替换为你的目标版本）、pyenv local 3.10.12绑定项目专属Python版本。
  • macOS/Linux：通过curl脚本安装pyenv，再执行版本安装和绑定命令。
• 嵌入式Python包
  下载对应系统的Python嵌入式压缩包，将其打包进安装程序，在安装脚本中自动解压到项目目录下的独立文件夹，完全隔离用户本地已有Python环境。

二、自动创建并配置虚拟环境 #

编写系统对应的自动化脚本（Windows用.bat，macOS/Linux用.sh），核心逻辑示例：

# Linux/macOS脚本示例
APP_DIR="$HOME/.local/share/YourAppName"
# 用指定Python版本创建虚拟环境
"$APP_DIR/python/bin/python" -m venv "$APP_DIR/venv"
# 激活虚拟环境并安装依赖
source "$APP_DIR/venv/bin/activate"
pip install -r "$APP_DIR/requirements.txt"
deactivate

@rem Windows批处理脚本示例
set APP_DIR=%LOCALAPPDATA%\YourAppName
"%APP_DIR%\python\python.exe" -m venv "%APP_DIR%\venv"
call "%APP_DIR%\venv\Scripts\activate.bat"
pip install -r "%APP_DIR%\requirements.txt"
deactivate

所有路径使用动态变量，避免硬编码，确保引用均指向本地安装目录。

三、打包项目并保留原结构 #

直接将完整项目目录（包含脚本、类文件、__init__.py、requirements.txt）打包为zip或tar.gz压缩包，完全保留原有目录结构。后续通过安装脚本自动解压到指定的应用存放目录即可。

若需要更规范的分发，也可使用setuptools生成源码分发包，但团队内部协作场景下，直接打包原目录更简单直观。

四、确定最佳应用存放位置 #

依据不同操作系统的规范设置默认路径：

• Windows：优先选择%LOCALAPPDATA%\YourAppName（无需管理员权限，用户专属空间），需全局访问时可选%PROGRAMFILES%\YourAppName（需管理员权限）。
• macOS：推荐~/Applications/YourAppName（用户专属）或/Applications/YourAppName（全局）。
• Linux：优先~/.local/share/YourAppName（用户专属），全局可选/opt/YourAppName。
  安装脚本中可通过判断系统类型，自动创建对应目录并解压项目文件。

整体分发方案推荐 #

方案1：一键安装程序（适合非技术用户） #

使用安装器工具将Python安装包、项目压缩包、自动化脚本打包为单文件安装程序：

• Windows：用Inno Setup或InstallForge，可视化配置安装流程，自动执行脚本完成所有环境配置，最后生成指向项目目录启动脚本的桌面快捷方式。
• macOS：用Packages或DMG Canvas制作dmg镜像，内置安装脚本自动完成配置。
• Linux：用deb/rpm打包工具将项目和脚本打包为系统包，用户通过包管理器一键安装。

方案2：容器化部署（适合技术团队） #

用Docker打包整个环境，用户无需安装Python和依赖：

1. 编写Dockerfile：

FROM python:3.10.12-slim
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
ENTRYPOINT ["python", "your_cli_script.py"]

2. 构建镜像并推送到团队内部镜像仓库，用户只需执行：

docker pull your-team-repo/your-app:latest
docker run --rm your-team-repo/your-app [参数]

可将上述命令封装为批处理/Shell脚本，用户双击即可运行。

注意事项 #

• 避免硬编码路径，所有路径通过环境变量或脚本动态获取。
• 测试不同系统的安装流程，确保兼容性。
• 若坚持用.exe方式，可使用pyinstaller的--onedir模式（而非单文件）保留项目结构，但仍需配合安装脚本配置环境，便捷性不如上述方案。

内容的提问来源于stack exchange，提问作者K.Veerina