aqua（声明式命令行工具版本管理器） 下载

简介

aqua 是一个用 Go 实现的声明式命令行工具版本管理器，它允许用户通过配置文件（如 aqua.yaml）定义项目所需的 CLI 工具及其版本，并自动完成安装、切换和校验。它支持按项目隔离工具版本，在团队和 CI 环境中实现版本一致性，并。（当前收录版本 2.65.2，适用 win/x64。）

详细介绍

aqua 是一款面向开发者和运维人员的命令行工具版本管理软件，采用 Go 语言编写，以声明式配置为核心。用户只需在项目根目录维护一个配置文件（如 aqua.yaml），列出所需的 CLI 工具及其版本，aqua 便会自动下载、安装并管理这些工具，确保团队成员和 CI 环境使用完全一致的版本。 核心功能包括： - 声明式管理：通过 YAML 配置文件定义工具和版本，支持全局和项目级配置。 - 自动安装与懒加载：当用户执行某个尚未安装的工具时，aqua 会自动安装它，实现按需安装。 - 版本切换：支持在同一项目或不同项目间无缝切换工具版本，无需手动干预。 - 交互式搜索：提供交互式界面，方便用户查找和添加工具。 - 安全机制：aqua 会校验下载文件的校验和（checksum），确保工具来源安全。 - 生态集成：提供 Renovate 配置预设，可自动更新工具版本；同时提供 GitHub Actions 和 CircleCI Orb，便于在 CI 中安装 aqua 和更新校验文件。 使用场景广泛，适用于个人开发环境、团队协作、持续集成/持续部署（CI/CD）流水线，以及需要管理多种 CLI 工具版本的项目。支持 Windows（x64）和 Linux 平台，当前提供 Windows 便携版压缩包。 适合希望统一工具版本、减少环境差异、提升开发效率的开发者、DevOps 工程师和技术团队。

适合人群

• 开发者统一本地开发环境
• 团队协作保证工具版本一致
• CI/CD 流水线中安装工具
• 需要管理多种 CLI 工具版本的项目
• 希望自动化工具安装的运维人员

安装教程

aqua 的安装与上手步骤如下：

1. 环境准备：aqua 需要 Go 环境（建议 1.20+），但运行 aqua 本身不需要 Go，仅编译时依赖。请确保系统已安装 Git（用于拉取工具仓库）。

2. 下载与解压：从官方发布页下载适用于 Windows x64 的便携版压缩包（如 aqua_windows_amd64-portable-win-x64.zip），解压到任意目录，例如 C:\aqua。将解压后的 aqua.exe 所在目录添加到系统 PATH 环境变量中。

3. 验证安装：打开命令提示符或 PowerShell，执行 `aqua version`，若显示版本号（如 2.65.2）则安装成功。

4. 初始化配置：在项目根目录运行 `aqua init`，会生成 aqua.yaml 配置文件。编辑该文件，添加所需工具，例如：
```yaml
registries:
- type: standard
ref: v4.0.0
packages:
- name: cli/cli
version: v2.40.0
```
然后执行 `aqua install` 安装所有列出的工具。

5. 使用懒加载：当执行一个未安装的工具时，aqua 会自动安装它。例如直接运行 `gh`，aqua 会检测并安装。

6. 版本切换：修改配置文件中的版本号，再次运行 `aqua install` 即可切换。

7. 注意事项：确保网络可访问 GitHub 等仓库；首次运行可能较慢；建议在 CI 中使用官方提供的 GitHub Actions 或 CircleCI Orb 以简化安装。

支持平台：Windows、Linux

版本与文件信息

• 版本：2.65.2
• 平台：win x64
• 文件名：aqua_windows_amd64-portable-win-x64.zip
• 文件大小：11.0 MB
• SHA256：628a8b1a1c0246e93e00a5deae59b0be234203740ee935851287a7c09ccfd748

下载地址

• 开源地址：https://aquaproj.github.io/
• baidu网盘：https://pan.baidu.com/s/1SzgL0szZ8-ZQvO_g3rutlw（提取码：eyzx）

常见问题

• aqua（声明式命令行工具版本管理器） 下载后无法安装怎么办？
  请确认系统满足 win 平台要求，并以管理员身份运行安装包；若提示缺少运行库，请先安装对应系统组件。
• 如何确认下载的文件是官方原版？
  通过页面上提供的 SHA256 校验值与官方公布值比对；一致即为官方原版，不一致请勿使用。
• aqua（声明式命令行工具版本管理器） 有绿色版或便携版吗？
  是否提供便携版以官方发布页为准；本站仅收录官方公开下载与网盘镜像，不提供破解或修改版本。

核心功能

• 下载前展示真实文件名「aqua_windows_amd64-portable-win-x64.zip」、版本 2.65.2、文件大小 11495974，以及适用平台 win/x64，便于逐项核对后再获取。
• 本站提供已校验的下载通道（baidu 网盘，提取码随页面展示），并保留官方站点入口作为备用来源。
• 能力覆盖：软件、Windows、开源，可按需选取对应功能模块。

使用场景

• 需要在本机部署或重装 aqua（声明式命令行工具版本管理器）（2.65.2），并希望先核对版本与文件信息再获取的场景。
• 处理「aqua（声明式命令行工具版本管理器）下载」相关需求、希望一次性拿到可核对文件与步骤时。
• 需要在多台设备使用同一 aqua（声明式命令行工具版本管理器） 版本（2.65.2），便于统一环境与后续排查时。

注意事项

• 获取文件后请核对文件名「aqua_windows_amd64-portable-win-x64.zip」与文件大小「11495974」是否与本页一致，避免拿到错误版本。
• 部署 aqua（声明式命令行工具版本管理器） 时路径建议避免中文与空格，可减少部分写入失败的概率。
• 若安全软件出现拦截提示，请先确认来源为本页收录渠道后再决定是否放行。

安装与校验

• 获取前先核对文件名、文件大小与版本号（本页：aqua_windows_amd64-portable-win-x64.zip / 11495974 / 2.65.2），逐项比对后再继续。
• 通过本页「baidu 网盘」通道转存到自己的网盘后再取回文件，可避免直接下载中断造成的文件不完整。
• 解压后先确认 aqua（声明式命令行工具版本管理器） 主程序能否正常启动，再决定是否替换原有版本。
• 如遇安全软件拦截，请先确认来源为本页收录渠道，再决定是否放行。

国内网盘获取步骤

• 第 1 步：在本页下载区打开「baidu」通道，先核对页面标注的版本号 2.65.2、平台 win/x64，再进入分享页。
• 第 2 步：输入本页展示的提取码完成校验（提取码以本页下载区为准，不要从第三方来源获取）。
• 第 3 步：把文件转存到自己的「baidu」账号后再下载，避免分享链接失效或下载中断；若为压缩包，建议解压到 C:\\Tools 这类不含中文与空格的路径。
• 第 4 步：下载完成后核对文件名「aqua_windows_amd64-portable-win-x64.zip」、文件大小「11495974」与版本号 2.65.2，与本页信息一致再安装或运行。