618 字
2 分钟
AutoEnv — Windows 开发环境一键安装工具
2025-06-19

每次重装系统或者换新电脑,最头疼的就是把开发环境重新装一遍——Node.js、Python、Java、Maven、Gradle、MySQL……一个个下载安装包、配置环境变量,费时费力还容易遗漏。

AutoEnv 就是为了解决这个问题而开发的。

AutoEnv 是什么#

AutoEnv 是一个 Windows 开发环境一键安装工具,支持 GUI 和 CLI 两种使用方式。启动后自动检测当前机器已有的环境,显示安装状态和版本号;已安装的组件可以直接卸载,未安装的可以一键批量安装。

当前支持的组件:

分类组件
Node.jsNode.js LTS
PythonPython 3.12
Java + SpringTemurin JDK 17、Maven、Gradle、Spring Boot CLI
DatabaseMySQL Server 8.4 LTS、Navicat Premium 17
JetBrainsPyCharm Professional、IntelliJ IDEA Ultimate、WebStorm

核心特性#

双模式运行#

既可以用图形界面操作,也可以用命令行:

Terminal window
# 图形界面
python app.py
# 命令行 - 安装全部
python -m src.cli install --all
# 命令行 - 安装指定组件
python -m src.cli install nodejs python java
# 查看状态
python -m src.cli status

智能安装策略#

安装器优先使用 winget(Windows Package Manager),如果系统没有 winget 会尝试自动安装。对于不支持 winget 的工具(如 Maven、Gradle、Spring Boot CLI),会自动下载 ZIP 包并解压安装,同时配置环境变量和 PATH。

winget 可用 → 直接安装
↓ 不可用
尝试安装 winget
仍然不可用
使用备用安装包(ZIP 下载 + 解压 + 配置环境变量)

国内镜像加速#

安装完成后会自动配置国内镜像源:

  • Node.js → npm 淘宝镜像
  • Python → pip 清华镜像

一键卸载#

已安装的组件可以在界面中直接卸载,不需要手动去控制面板找。

技术实现#

AutoEnv 基于 Python 构建,核心架构:

  • pywebview — 轻量级桌面 GUI,用 HTML/CSS/JS 渲染界面
  • winget CLI — 调用 Windows Package Manager 安装/卸载
  • JSON 配置config/packages.json 定义所有支持的组件,方便扩展
  • PyInstaller — 打包成单个 exe,双击即用

项目结构:

AutoEnv/
├── app.py # 入口,启动 GUI
├── config/
│ └── packages.json # 组件定义
├── src/
│ ├── backend.py # GUI 后端 API
│ ├── cli.py # 命令行接口
│ ├── installer.py # 安装引擎(winget + zip fallback)
│ ├── package_config.py # 配置加载
│ └── ui/ # 前端界面
├── build_exe.ps1 # 打包脚本
└── AutoEnv.spec # PyInstaller 配置

如何扩展#

添加新的安装组件非常简单,只需要在 config/packages.json 中补充一条配置:

{
"id": "tool-id",
"name": "Tool Name",
"category": "Category",
"winget_id": "Vendor.Package",
"check_command": ["tool", "--version"],
"post_install_commands": []
}

支持的字段:

字段说明
winget_idwinget 包标识符
check_command检测是否已安装的命令
fallback_kind备用安装方式:exezip
fallback_installers备用下载地址列表
archive_env_varsZIP 安装后需要设置的环境变量
post_install_commands安装后执行的命令(如配置镜像源)

下载使用#

项目地址:Nth2Miss/AutoEnv

  1. 安装 Python 3.12+
  2. 克隆仓库
  3. 运行 python app.py(建议管理员权限)

或者直接下载打包好的 exe,双击运行即可。

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

AutoEnv — Windows 开发环境一键安装工具
https://blog.nth2miss.cn/posts/autoenv/
作者
Nth2Miss
发布于
2025-06-19
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时

目录