# env-auto-setup **Repository Path**: ccubee/env-auto-setup ## Basic Information - **Project Name**: env-auto-setup - **Description**: 开发背景 每次入职新公司、拿到一台新电脑、或者给同事讲解怎么搭建后端 / 前端开发环境，都要重复一系列繁琐的步骤： 找官网 —— Oracle 现在要登录才能下 JDK？Adopt - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: https://www.oschina.net/p/env-auto-setup - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-09-22 - **Last Updated**: 2026-09-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 编程开发环境自动装配小工具 (env-auto-setup)

env-auto-setup 主界面截图

一款基于 Python + PySide6 的跨平台桌面 GUI 工具
一键完成 下载 → 解压 → 环境变量配置 全流程，让开发环境搭建不再是重复劳动

python platform license pyside6 release

--- ## 📥 下载即用（推荐） > **不需要 Python 环境，不需要克隆源码，双击即可运行。** 请到 **[Releases 页面](https://github.com/vfaner/env-auto-setup/releases/latest)** 下载对应操作系统的最新版本： | 系统 | 下载文件 | 说明 | |------|----------|------| | 🪟 **Windows** | [`env-auto-setup.exe`](https://github.com/vfaner/env-auto-setup/releases/latest/download/env-auto-setup.exe) | 双击运行，无需安装 | | 🍎 **macOS (Apple Silicon)** | [`env-auto-setup-macos-arm64.zip`](https://github.com/vfaner/env-auto-setup/releases/latest/download/env-auto-setup-macos-arm64.zip) | 解压后双击 `env-auto-setup.app` | | 🍎 **macOS (通用)** | [`env-auto-setup-macos.zip`](https://github.com/vfaner/env-auto-setup/releases/latest/download/env-auto-setup-macos.zip) | 解压后双击 `env-auto-setup.app` | | 🐧 **Linux (x64)** | [`env-auto-setup-linux-x64`](https://github.com/vfaner/env-auto-setup/releases/latest/download/env-auto-setup-linux-x64) | `chmod +x` 后直接运行 | ### 首次启动提示 - **macOS**：由于未做代码签名，首次打开时系统可能提示"无法验证开发者"。请到「系统设置 → 隐私与安全性」下方点击 **"仍要打开"**；或用 `xattr -cr env-auto-setup.app` 移除隔离属性。 - **Windows**：Defender / SmartScreen 可能弹出"未识别应用"，点击 **"更多信息 → 仍要运行"** 即可。 - **Linux**：如果双击无响应，请在终端执行 `chmod +x env-auto-setup-linux-x64 && ./env-auto-setup-linux-x64`。 > 💡 只想看看代码 / 自己二次开发？往下翻到 [开发者指南](#-快速开始)。 --- ## 📖 目录 - [下载即用](#-下载即用推荐) - [开发背景](#-开发背景) - [项目描述](#-项目描述) - [功能特性](#-功能特性) - [支持的组件](#-支持的组件) - [环境要求](#-环境要求) - [快速开始](#-快速开始)（源码开发者） - [使用说明](#-使用说明) - [截图预览](#-截图预览) - [配置与自定义](#-配置与自定义) - [目录结构](#-目录结构) - [常见问题（FAQ）](#-常见问题faq) - [技术栈](#-技术栈) - [支持作者](#-支持作者) - [许可证](#-许可证) --- ## 🌱 开发背景 每次入职新公司、拿到一台新电脑、或者给同事讲解怎么搭建后端 / 前端开发环境，都要重复一系列繁琐的步骤： 1. **找官网** —— Oracle 现在要登录才能下 JDK？Adoptium Temurin 是哪个包才对？MySQL 官方的 zip 藏在哪个二级页面？ 2. **对系统 / 架构** —— macOS 是 Intel 还是 Apple Silicon？Linux 用 glibc 哪个版本？ 3. **解压 + 放到"正确"的位置** —— 一堆 `C:\Program Files\...` 还是 `~/tools/...` 的目录规划。 4. **配置环境变量** —— Windows 上要点开"高级系统设置 → 环境变量 → 用户变量 / 系统变量 → 新建"；macOS/Linux 要区分 `.zshrc`、`.bash_profile`、`.bashrc`、`.profile` 里到底写在哪个才生效。 5. **验证** —— 打开新终端 `java -version`、`mvn -v` …… 一个不对就重来。 一台电脑做完至少半小时，多台电脑或者带新人上手时更是重复劳动。**能不能把这些交给一个工具？** 于是有了这个项目： > 让「新机器 → 一套完整开发环境」这件事变成 **点几下鼠标** 就搞定。 --- ## 📌 项目描述 **env-auto-setup** 是一款开源的桌面小工具，目标是把开发者最常用的语言运行时、构建工具、中间件的下载与配置全部自动化。 它做了这几件事： - ✅ **智能识别系统**：自动判断 Windows / macOS / Linux + CPU 架构（x64 / arm64），挑选正确的官方分发包 - ✅ **动态版本抓取**：启动时向各官方 API / 归档索引拉取最新可用版本列表（Adoptium、Apache Maven / Tomcat、python.org、Node.js dist、GitHub Releases、Anaconda Repo），不再依赖硬编码 - ✅ **可搜索下拉框**：版本列表长？直接键入 `21` / `3.12` / `LTS` 实时过滤 - ✅ **自动检测已装环境**：如果系统已经有 `java` / `mvn` / `python`，会显示 ✓ 已配置 状态并禁用"配置环境变量"按钮，避免重复写入 - ✅ **一键下载 → 解压 → 配环境变量**：Windows 下走 `winreg`，macOS/Linux 下带 marker 幂等写入 shell 配置文件 - ✅ **安装器模式**：Miniconda 这类 `.exe` / `.sh` 安装器，工具会以静默参数自动执行安装 - ✅ **现代化 UI**：无边框自定义标题栏、卡片式布局、渐变进度条、彩色分级日志、状态胶囊标签 --- ## ✨ 功能特性 | 特性 | 说明 | |------|------| | 🖥️ **跨平台** | 一份代码同时支持 Windows / macOS / Linux；ARM64 分支自动切换（如 Apple Silicon 下 JDK 走 aarch64、Node 走 arm64） | | 📦 **一键装配** | 内置 **8 大** 常用开发组件，从下载 → 解压 → 环境变量配置全流程自动化 | | 🌐 **动态版本抓取** | 后台线程并发调用各组件官方 API / 索引，拉取最新可用版本，抓取失败自动降级到内置默认清单 | | 🔍 **智能检测** | 优先检查 `XXX_HOME` 环境变量，然后回退到 `PATH` 中的可执行文件；探测到即视为已配置 | | 🎯 **可搜索下拉框** | 版本多？直接键入关键字实时过滤，回车即可选中 | | 🛠️ **环境变量写入** | Windows：`winreg` + `setx`；macOS/Linux：写入带标记的 shell 配置块，幂等更新 | | 🚀 **安装器模式** | 支持 `.exe` / `.sh` 静默安装（Miniconda），无弹窗交互 | | 📊 **实时反馈** | 进度条显示下载速度和大小，可随时取消；日志区彩色分级输出 | | 🎨 **现代化界面** | 圆角卡片 + 阴影、渐变进度条、状态胶囊标签、无边框自定义窗口 | | 🧠 **偏好记忆** | 记住上一次每个组件选择的版本，下次启动自动恢复 | | 💰 **打赏支持** | 内置微信 / 支付宝 / QQ 二维码，一键支持作者 | --- ## 📦 支持的组件 | 组件 | 显示名 | 环境变量 | 检测命令 | 默认版本 | |------|--------|----------|----------|----------| | **JDK** | JDK (Temurin) | `JAVA_HOME` | `java -version` | 21 / 17 (LTS) / 11 / 8 | | **Maven** | Apache Maven | `MAVEN_HOME` | `mvn -v` | 3.9.x / 3.8.x | | **Tomcat** | Apache Tomcat | `CATALINA_HOME` | `catalina version` | 10.1 / 9.0 / 8.5 | | **MySQL** | MySQL Server | `MYSQL_HOME` | `mysql --version` | 8.0.x / 5.7.x | | **Python** | Python | — (走 PATH) | `python --version` | 3.12 / 3.11 / 3.10 / 3.9 | | **Node.js** | Node.js | `NODE_HOME` | `node --version` | 20 LTS / 18 LTS / 16 | | **Git** | Git | — | `git --version` | MinGit for Windows / 系统自带 | | **Miniconda** | Miniconda | `CONDA_HOME` | `conda --version` | py312 / py311 / py310 | > 💡 启动应用后，"⟳ 刷新版本"按钮会自动请求各官方源，拉取当前所有可用版本。抓取失败会回退到硬编码的内置清单，保证程序在离线环境下也可用。 --- ## 💻 环境要求 - **Python**：3.9 及以上 - **操作系统**：Windows 10 / 11、macOS 12+、Ubuntu 20.04+ - **网络**：需要能访问对应组件的下载源（如 Apache 归档、Adoptium API、Node.js dist 等） - **磁盘**：视安装的组件而定，建议预留 3 GB 以上（JDK+Maven+Node+Python+MySQL 加起来约 1.5-2 GB） --- ## 🚀 快速开始 > 📌 **本节面向开发者 / 想二次开发的用户**。只想使用工具？请回到 [下载即用](#-下载即用推荐)。 ### 1. 克隆项目 ```bash git clone https://github.com/yourname/env-auto-setup.git cd env-auto-setup ``` ### 2. 创建虚拟环境（推荐） ```bash python -m venv .venv # Windows .venv\Scripts\activate # macOS / Linux source .venv/bin/activate ``` ### 3. 安装依赖 ```bash pip install -r requirements.txt ``` 依赖清单： - `PySide6` — Qt for Python，提供跨平台 GUI - `requests` — HTTP 请求，用于下载文件和抓取版本列表 ### 4. 启动应用 ```bash python main.py ``` 首次启动会自动创建工作目录： ``` ~/.env-tools/ # 所有下载的压缩包 / 解压后的组件都放这里 ├── jdk/ │ ├── downloads/ # 原始压缩包 │ └── jdk-17/ # 解压后的 JDK ├── maven/ ├── node/ └── ... ``` --- ## 📝 使用说明 ### 基本流程 1. **打开应用** → 主界面会显示所有支持的组件卡片，每个卡片右上角会显示 **当前系统检测结果**： - 🟢 `✓ 已配置（PATH）· openjdk version "17.0.10"` — 系统已能找到，无需再装 - 🟠 `● 已下载，未配置` — 本地已有安装包，但环境变量未设置 - 🔴 `○ 未安装` — 完全没有 2. **选择版本** → 点击版本下拉框： - 直接从列表点击选择 - 或者输入关键字（如 `21`、`3.12`、`LTS`）实时过滤 3. **点击"下载并安装"** → 工具会： - ⬇️ 流式下载到 `~/.env-tools/<组件>/downloads/`（可随时取消） - 📂 解压到 `~/.env-tools/<组件>/<组件>-<版本>/`（Miniconda 走静默安装器） - 🔧 自动写入 `XXX_HOME` 环境变量 + 把 `bin` 追加到 `PATH` 4. **或点击"配置环境变量"** → 使用本地已下载的最新版本，仅执行环境变量配置 5. **查看日志** → 底部日志区实时显示每一步的执行情况 ### 环境变量生效方式 - **Windows**：新开命令行/PowerShell 窗口即可读到新的用户变量；已打开的窗口需要重启 - **macOS / Linux**： ```bash source ~/.zshrc # 或 ~/.bashrc / ~/.bash_profile / ~/.profile ``` 或直接重开终端 ### 验证方法 ```bash java -version mvn -v python --version node -v mysql --version git --version conda --version ``` --- ## 📸 截图预览

主界面

界面元素说明： - **顶部**：自定义标题栏，包含 GitHub 链接、打赏按钮、窗口控制（最小化 / 最大化 / 关闭） - **中部**：每个组件一张卡片，展示名称、状态标签、版本下拉框（可搜索）、操作按钮、进度条 - **底部**：运行日志区，四色分级输出（info 灰、ok 绿、warn 橙、error 红） - **状态栏**：显示当前系统信息与工作目录 --- ## 🔧 配置与自定义 ### 修改 / 新增组件版本 打开 `main.py`，找到 `build_components()` 函数。每个组件的默认版本列表都在这里。如需新增或调整： ```python components.append( Component( key="jdk", display_name="JDK (Temurin)", env_var="JAVA_HOME", path_subdir="bin", exec_name="java", version_args=["-version"], versions=[ ComponentVersion( version=v, url_map=_adoptium_jdk_url(v), archive_map={"Windows": "zip", "Darwin": "tar.gz", "Linux": "tar.gz"}, ) for v in ("22", "21", "17", "11", "8") # 加入 22 ], ) ) ``` > ⚠️ 提示：`versions` 只是**离线默认清单**。启动时后台会自动向官方 API 拉取真实版本，覆盖此清单。你也可以通过修改 `FETCHERS` 字典自定义抓取逻辑。 ### 更换下载镜像 如果官方下载慢，可修改 `main.py` 中的 URL 生成函数，替换成国内镜像： - 🇨🇳 **华为云**：`https://repo.huaweicloud.com/` - 🇨🇳 **清华 TUNA**：`https://mirrors.tuna.tsinghua.edu.cn/` - 🇨🇳 **阿里云**：`https://mirrors.aliyun.com/` 示例：把 Maven 的下载地址改成清华镜像 ```python def _maven_urls(v: str) -> Dict[str, str]: base = f"https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/{v}/binaries/apache-maven-{v}-bin" return { "Windows": f"{base}.zip", "Darwin": f"{base}.tar.gz", "Linux": f"{base}.tar.gz", } ``` ### 修改工作目录 默认工作目录是 `~/.env-tools/`。在 `main.py` 顶部修改： ```python CONFIG_DIR = Path.home() / ".env-tools" ``` --- ## 📦 自行打包 / 发布新版本 项目已经配置好 PyInstaller 与 GitHub Actions，你可以： ### 本地打包（单平台） ```bash pip install pyinstaller pyinstaller env-auto-setup.spec --noconfirm --clean ``` 产物： - Windows：`dist/env-auto-setup.exe` - macOS：`dist/env-auto-setup.app` - Linux：`dist/env-auto-setup` ### 自动发布三平台版本（推荐） 推一个 tag 到 GitHub，`.github/workflows/build-and-release.yml` 会在 Windows / macOS / Linux 三个 runner 上分别打包，并自动上传到对应 Release： ```bash git tag v1.0.1 git push origin v1.0.1 ``` 几分钟后到 Releases 页面就能看到三个平台的产物。 --- ## 📁 目录结构 ``` env-auto-setup/ ├── main.py # 主程序（含 UI 与全部逻辑） ├── requirements.txt # Python 依赖清单 ├── env-auto-setup.spec # PyInstaller 打包配置 ├── README.md # 中文说明（本文件） ├── README_EN.md # 英文说明 ├── LICENSE # MIT 许可证 ├── .gitignore # Git 忽略规则 ├── .github/ │ └── workflows/ │ └── build-and-release.yml # 三平台自动构建 + 发布 └── assets/ # 静态资源 ├── env-auto.png # 应用截图 ├── wechat.png # 微信收款码 ├── alipay.png # 支付宝收款码 └── qq.png # QQ 收款码 ``` --- ## ❓ 常见问题（FAQ） **Q1. 启动后下拉框显示"获取失败"？** 可能是网络原因或访问受限（如 GitHub API 在部分地区不稳定）。工具会自动回退到内置默认版本列表，仍然可以下载安装 —— 只是版本可能不是最新。**默认版本完全可用**。也可以更换镜像见「配置与自定义」章节。 **Q2. 下载卡在某个百分比不动？** 可能是网络原因或镜像限速。点击 **「取消」** 后重试；或参考"配置与自定义"章节替换成国内镜像。 **Q3. 提示环境变量写入失败？** - Windows：请以"管理员身份"重新启动本程序（默认写入的是**用户级**变量，通常不需要管理员权限） - macOS / Linux：确认你有 `~/.zshrc` 等文件的写入权限 **Q4. 已经存在旧的 `JAVA_HOME`，会被覆盖吗？** 会用最新一次安装的路径覆盖原有值；同时把新的 `bin` 目录追加到 `PATH`（不会重复追加）。 **Q5. MySQL 解压完成后能直接用吗？** 不能。MySQL 解压后还需要执行 `mysqld --initialize` 等初始化步骤。本工具只完成"下载 + 解压 + 环境变量"三步，不做数据库初始化。 **Q6. `.tar.xz` 归档能处理吗？** 可以，程序内置了 `tarfile.open("r:xz")` 逻辑（用于 MySQL Linux 版）。 **Q7. Windows 上 PATH 超过 1024 字符怎么办？** `setx` 有 1024 字符限制，工具会额外通过 `winreg` 直接写入注册表来规避该限制。 **Q8. Miniconda 静默安装到哪里？** 安装到 `~/.env-tools/conda/conda-<版本>/`，并把 `CONDA_HOME` 与 `bin/Scripts` 加入环境变量。 **Q9. 可以只做检测不做安装吗？** 可以。启动时工具就会检测所有组件的状态；如果所有组件都显示 ✓ 已配置，说明你的系统已经就绪，不需要再点任何按钮。 **Q10. 支持自动更新组件版本吗？** 点击卡片的下拉框会先看到内置版本，程序启动后后台自动请求官网并热更新列表。所以理论上"最新版本"是实时的（前提是能访问对应官网）。 --- ## 🛠️ 技术栈 - **Language**：Python 3.9+ - **GUI 框架**：[PySide6](https://doc.qt.io/qtforpython-6/)（Qt 6 官方 Python 绑定，LGPL 授权） - **HTTP 客户端**：[requests](https://requests.readthedocs.io/) - **压缩包解压**：Python 标准库 `zipfile` + `tarfile` - **环境变量**： - Windows：`winreg` 直写注册表 + `setx` 通知系统 - macOS/Linux：写入 shell 配置文件（`.zshrc` / `.bash_profile` / `.bashrc` / `.profile`） - **多线程**：`QThread` 后台下载与版本抓取，UI 不阻塞 - **架构**：单文件应用，`main.py` 内含 UI、数据类、业务逻辑 --- ## 💖 支持作者 如果这个小工具对你有帮助，欢迎请作者喝杯咖啡 ☕：
微信
微信 		支付宝
支付宝 		QQ
QQ
也欢迎： - ⭐ 给本项目点个 Star - 🐛 提 Issue 反馈问题 - 🔀 提 PR 贡献代码 - 📢 分享给身边的朋友 --- ## 📄 许可证 本项目采用 **MIT License** 开源发布，版权归作者 **rgh** 所有。 ``` MIT License Copyright (c) 2026 rgh Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ``` 许可证全文亦可参考 。 ---

Made with ❤️ by rgh
如果觉得有用，别忘了给个 ⭐ Star！