环境自动装配小工具 (env-auto-setup)

📥 下载即用（推荐）

不需要 Python 环境，不需要克隆源码，双击即可运行。

请到 Releases 页面 下载对应操作系统的最新版本：

首次启动提示

• macOS：由于未做代码签名，首次打开时系统可能提示"无法验证开发者"。请到「系统设置 → 隐私与安全性」下方点击 "仍要打开"；或用 xattr -cr env-auto-setup.app 移除隔离属性。
• Windows：Defender / SmartScreen 可能弹出"未识别应用"，点击 "更多信息 → 仍要运行" 即可。
• Linux：如果双击无响应，请在终端执行 chmod +x env-auto-setup-linux-x64 && ./env-auto-setup-linux-x64。

💡 只想看看代码 / 自己二次开发？往下翻到 开发者指南。

🌱 开发背景

每次入职新公司、拿到一台新电脑、或者给同事讲解怎么搭建后端 / 前端开发环境，都要重复一系列繁琐的步骤：

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：无边框自定义标题栏、卡片式布局、渐变进度条、彩色分级日志、状态胶囊标签

✨ 功能特性

📦 支持的组件

💡 启动应用后，"⟳ 刷新版本"按钮会自动请求各官方源，拉取当前所有可用版本。抓取失败会回退到硬编码的内置清单，保证程序在离线环境下也可用。

💻 环境要求

• 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. 克隆项目

git clone https://github.com/yourname/env-auto-setup.git
cd env-auto-setup

2. 创建虚拟环境（推荐）

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

依赖清单：

• PySide6 — Qt for Python，提供跨平台 GUI
• requests — HTTP 请求，用于下载文件和抓取版本列表

4. 启动应用

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：

  source ~/.zshrc        # 或 ~/.bashrc / ~/.bash_profile / ~/.profile
  

  或直接重开终端

验证方法

java -version
mvn -v
python --version
node -v
mysql --version
git --version
conda --version

💖 支持作者

如果这个小工具对你有帮助，欢迎请作者喝杯咖啡 ☕：
如果觉得有用，别忘了给个 ⭐ Star！
项目源码地址：https://github.com/vfaner/env-auto-setup