YCBlogs Groovy 学习笔记（一）：Mac、Linux 与 Windows 下 Groovy 的下载安装及环境配置实战

• 教程
• 技术博客
• 文档

本指南以 YCBlogs 仓库中 Groovy学习笔记1：下载及配置环境 为核心，系统讲解 Groovy 在 Mac/Linux 与 Windows 两大平台上的下载、安装与 IDEA 集成配置全过程。读完本文，你将掌握 SDKMAN 命令行安装、Windows Installer 一键安装、环境变量验证、groovyConsole交互调试，以及将 Groovy SDK 接入 IntelliJ IDEA 的完整方法，为后续阅读本仓库的 Groovy 语法系列笔记与自动化脚本实战打下环境基础。

一、为什么开发机需要配置 Groovy 环境

Groovy 是一种基于 JVM 的动态语言。对于 Android 开发者而言，Groovy 最广为人知的应用场景是Gradle 构建脚本——如仓库中 Gradle学习笔记（一）基本配置 所述："Gradle 构建脚本的书写没有基于传统的 XML 文件，而是基于 Groovy 的领域专用语言（DSL）"。这意味着理解并运行 Gradle 脚本，本质上就是在与 Groovy 语法打交道。

同时，Groovy 也是编写自动化脚本的高效工具。仓库中的 Android-用Groovy实现扇贝阅读APP的自动阅读功能 展示了一个纯 Groovy 脚本如何配合 ADB 命令完成手机端模拟阅读、截图比对、自动点击的完整流程。

从 Groovy学习笔记2：Groovy的基本语法 中的运行输出可以确认：Groovy Version: 2.4.15 JVM: 1.8.0_131，即Groovy 依赖 JVM 运行。因此在安装 Groovy 之前，请确保开发机已安装并配置好 JDK（示例环境为 JVM 1.8.0_131，其他较新版本同样适用）。

二、安装方式总览：官网两种主流选择

进入 Groovy 官方下载页面（groovy-lang.org/download.html）可以看到，官方提供了两条主流的安装路径：

对于 Mac 或 Linux 用户，官方更推荐使用SDKMAN这一开发者安装工具。SDKMAN（Software Development Kit Manager）可以为 JVM 生态安装多种开发工具包，除了 Groovy，还支持 Java、Scala、Kotlin、Ceylon，以及 Ant、Gradle、Grails、Maven、SBT、Spark、Spring Boot、Vert.x 等构建与框架工具。

三、Mac 与 Linux 下通过 SDKMAN 配置 Groovy

1. 安装 SDKMAN 本体

按照官方给出的两步命令即可完成 SDKMAN 的下载与初始化。首先下载 SDKMAN：

$ curl -s get.sdkman.io | bash

然后让当前 Shell 会话加载 SDKMAN 的初始化脚本：

$ source "$HOME/.sdkman/bin/sdkman-init.sh"

提示：source命令只对当前终端会话生效。如果新开一个终端窗口发现sdk命令不可用，请检查 SDKMAN 是否已将初始化语句写入~/.bashrc（或~/.zshrc）等 Shell 配置文件中，重新source或重开终端即可。

2. 安装 Groovy

SDKMAN 就绪后，一条命令即可安装最新版 Groovy：

$ sdk install groovy

如需安装指定版本或查看可用版本，可以结合 SDKMAN 的候选列表能力操作：

$ sdk list groovy # 查看 groovy 候选版本列表 $ sdk install groovy 2.4.15 # 安装指定版本（示例版本号） $ sdk current groovy # 查看当前使用的 groovy 版本

其中2.4.15正是仓库笔记运行示例中所使用的版本，可作为历史兼容场景的参考。

3. 验证安装结果

安装完成后，运行以下命令确认 Groovy 是否安装成功：

$ groovy -version

输出类似（来自仓库笔记的真实运行记录）：

Groovy Version: 2.4.15 JVM: 1.8.0_131 Vendor: Oracle Corporation OS: Mac OS X

4. 打开 Groovy Console

验证版本成功后，可以直接在命令行打开 Groovy 的图形化控制台，开始 Groovy 之旅：

$ groovyConsole

groovyConsole是 Groovy 自带的轻量级交互开发界面，非常适合练习语法、快速验证代码片段。此外还可以在命令行直接输入groovy进入交互式 REPL（即groovysh），逐行执行 Groovy 语句。

四、Windows 下配置 Groovy

1. 使用 Windows Installer 一键安装

Windows 用户直接进入官网下载页面，点击Windows installer，下载对应的 exe 可执行文件。下载完毕后双击运行，按向导"傻瓜式"安装即可。

Windows Installer 会自动帮你配置好环境变量，因此无需手工编辑 PATH。安装完成后，重点工作是确认环境变量是否正确配置：

• 检查系统环境变量中是否新增了GROOVY_HOME（指向 Groovy 安装目录）；
• 检查PATH中是否已追加%GROOVY_HOME%\bin（Mac 风格为$GROOVY_HOME/bin）。

2. 命令行验证

打开 cmd 命令行，依次执行以下两条命令进行测试：

> groovy -version > groovyConsole

• groovy -version验证 Groovy 命令是否进入 PATH；
• groovyConsole验证图形化控制台能否正常启动。

如果出现"不是内部或外部命令"的报错，说明 PATH 未生效，请重新打开 cmd（环境变量修改后需重启终端）或检查安装目录下的bin文件夹是否已加入 PATH。

3. Windows 上的可选方案

除官方 Windows Installer 外，如果你习惯在类 Unix 环境（如 Git Bash、WSL）中工作，也可以使用第三节介绍的 SDKMAN 方式完成安装，两种方式得到的groovy、groovyConsole命令用法完全一致。

五、在 IntelliJ IDEA 中配置 Groovy SDK

命令行安装只是第一步，日常开发更常借助 IDE 使用 Groovy。在 IDEA 中使用 Groovy 非常简单：直接新建一个.groovy后缀的文件即可，但前提是必须先把 Groovy 的 SDK 配置给 IDEA。

1. 打开 Groovy SDK 配置入口

在 IDEA 中进入语言与框架设置页，找到 Groovy 配置项，点击Configure Groovy SDK，选择 Groovy 的根目录完成配置即可。

2. 定位 SDKMAN 安装的 Groovy 根目录

SDKMAN 虽然让下载安装 Groovy 变得非常简单，但可能导致 Groovy 的根目录不太好找。SDKMAN 将所有候选工具统一安装在用户主目录的隐藏文件夹中，按照 SDKMAN 的目录约定，各候选包位于~/.sdkman/candidates/<工具名>/下，对应 Groovy 的根目录为：

/Users/(用户名)/.sdkman/candidates/groovy/[(版本号)|current]

说明：仓库原笔记中该路径写作candidates/gradle，应为笔误——SDKMAN 的目录结构按工具名分目录，Groovy 对应candidates/groovy；current是指向当前激活版本的符号链接，始终指向最新使用的版本，配置时优先选择current目录最稳妥。

由于.sdkman是隐藏目录，在 Finder 中默认不可见，需要按Cmd+Shift+.控制隐藏文件的显示，才能浏览到该目录。

3. 配置完成后的验证

SDK 配置完成后，在 IDEA 中右键运行.groovy文件即可，控制台会输出脚本执行结果。后续即可正常享受 IDEA 提供的语法高亮、补全与调试能力。

六、环境就绪：验证第一个 Groovy 程序

安装配置完成之后，用仓库笔记中的经典案例做一次端到端验证。新建A01_GroovyApp.groovy，写入以下代码（来自 Groovy学习笔记2：Groovy的基本语法）：

class A01_GroovyApp { public static void hello() { println('Hello Groovy!') } public static void main(String[] args) { hello() } }

运行结果：

Hello Groovy!

从这段代码可以直观感受到 Groovy 的简洁：方法体可以省略大括号、语句末尾可以省略分号、字符串用单引号即可。这正是 Gradle 构建脚本（Gradle学习笔记（一）基本配置 中的buildscript {}、apply plugin:等 DSL 代码块）能够如此精简的底层原因。

七、配置好环境之后能做什么：仓库内的 Groovy 实战印证

环境配置的价值最终要落到使用上。本仓库为 Groovy 提供了从语法到实战的完整学习路径，读者可以在配置好环境后按序阅读：

1. 语法系列笔记

• Groovy学习笔记2：Groovy的基本语法：涵盖 Java 与 Groovy 对比、四种循环写法（for (i in 0..4)、upto、times、step）、GDK 扩展（如"svn help".execute().text一行执行系统命令）、JavaBean、具名参数、可选形参与多赋值；
• Groovy学习笔记3：接口，布尔判断，操作符重载：展示闭包配合as操作符直接实现接口、不强制实现接口全部方法的特性；
• Groovy学习笔记4：特殊注解：讲解@Canonical、@Delegate、@Immutable、@Lazy、@Newify、@Singleton等编译期变换注解，体会 Groovy 以更少代码完成更多工作的风格。

2. 自动化脚本实战

Android-用Groovy实现扇贝阅读APP的自动阅读功能 是环境配置的最佳实战检验：一个 Groovy 脚本调用"adb shell input keyevent 20".execute()模拟翻页、"adb shell screencap -p /sdcard/...".execute()截图、"adb shell input tap 540 1730".execute()点击按钮，并用均值哈希算法比较相邻截图的相似度来判断是否翻页到底。整个脚本完全依赖 Groovy 的execute()方法与闭包特性，无需任何额外框架即可运行——这正是环境配置完成后能够立刻投入使用的典型场景。

八、常见问题与排查要点

小结

本笔记围绕 Groovy学习笔记1：下载及配置环境 展开，完整覆盖了三条主线：Mac/Linux 下通过 SDKMAN 的命令行安装（curl -s get.sdkman.io | bash→source→sdk install groovy→groovy -version→groovyConsole）、Windows 下通过官方 Installer 的图形化安装与环境变量确认，以及将 SDK 接入 IntelliJ IDEA 的配置细节。环境配置是 Groovy 学习的第一步，也是仓库后续语法笔记（基本语法、接口与操作符、特殊注解）与实战案例（ADB 自动阅读脚本）能够顺利运行的前提。完成本环境配置后，即可在命令行或 IDEA 中直接进入 Groovy 的世界。

• 教程
• 技术博客
• 文档