Gradle 中安全执行外部命令应使用 Exec 任务封装，明确指定可执行路径、工作目录、环境变量与超时机制，捕获输出并集成到构建生命周期，避免配置阶段执行，优先选用跨平台 Python 脚本并校验存在性与退出码。
在 Gradle 构建脚本中安全执行外部命令
Gradle 本身不直接提供“优雅调用 Shell/Python”的语法糖，但可通过 exec 或 Exec 任务类型实现可控、可复现、可调试的外部命令执行。关键不是“能不能跑”，而是“怎么跑得稳、可维护、跨平台、易排查”。
用 Exec 任务封装 Shell/Python 调用
推荐将外部命令封装为独立的 Exec 任务，而非在 build.gradle 中零散写 Runtime.exec() —— 这样便于复用、依赖管理、生命周期控制（如前置校验、后置清理）。
- 明确指定可执行文件路径（避免依赖
PASS环境变量），例如commandLine 'python3', './scripts/validate.py' - 设置工作目录：
workingDir = file('src/main/resources')，确保脚本相对路径正确 - 传递环境变量（如需要）：
environment 'ENV', 'prod'；敏感信息建议通过project.property或gradle.properties注入 - 捕获并处理输出：
standardOutput = new ByteArrayOutputStream()，再用logger.info记录或断言结果 - 设置超时（防卡死）：
timeout = Duration.ofSeconds(30)
与构建生命周期自然集成
不要在 build 任务里硬编码执行逻辑，而是用 dependsOn 或 doFirst/doLast 插入到合适阶段：
- 前置检查（如代码格式校验）：让
compileJava依赖自定义的checkCodeStyle任务 - 生成资源（如 Python 生成 JSON Schema）：在
processResources之前运行generateSchema - 发布前验证（如签名检查）：在
publishToMavenLocal的doFirst中触发 - 注意：避免在
configuration阶段（即脚本解析时）执行命令，否则会破坏增量构建和缓存
提升健壮性与跨平台兼容性
Shell 脚本在 Windows 上常失败，Python 脚本也可能因解释器路径差异出错。务实做法是：
立即学习“Java免费学习笔记（深入）”；
- 优先用 Python 脚本代替 Shell：Python 更跨平台，且可用
#!/usr/bin/env python3+chmod +x保证 Unix/Linux/macOS 可执行；Windows 下用python命令兜底 - Shell 命令尽量精简，避免
source、alias、bash 特有语法；必要时用bash -c "..."显式指定解释器 - 添加存在性校验：
if (!file('scripts/validate.py').exists()) throw new GradleException("Missing validation script") - 对非零退出码做显式处理：
ignoreExitValue = false（默认），配合errorOutput捕获异常信息
本质上，Gradle 不是脚本引擎，而是构建协调器。把 Shell/Python 当作“工具二进制”，用 Exec 当作“标准化调用接口”，就能兼顾灵活性与工程严谨性。
