如何在 Go 程序中正确执行 Bash 脚本_技术教程

本文详解如何使用 go 的 `os/exec` 包安全、可靠地执行本地 bash 脚本，涵盖路径处理、错误诊断、输出捕获及常见陷阱（如 exit status 127），并提供可直接运行的完整示例。

在 Go 中执行 Bash 脚本看似简单，但实际开发中常因路径错误、权限缺失或 shell 解析机制差异导致失败（例如 exit status 127 —— 这是 Unix/Linux 中“命令未找到”的标准错误码）。你遇到的问题正源于此：exec.Command("/bin/sh", "hello.sh") 尝试在 /bin/sh 目录下查找 hello.sh，而它实际位于当前工作目录（即 hello/ 根目录），因此 shell 无法定位脚本文件。

✅ 正确做法：指定绝对路径 + 捕获输出

首先确保 hello.sh 具备可执行权限：

chmod +x hello.sh

然后在 hello.go 中使用 exec.Command 配合 Output() 方法（推荐用于需获取 stdout 的场景）：

package main

import (
    "fmt"
    "log"
    "os"
    "os/exec"
    "path/filepath"
)

func runHelloScript() ([]byte, error) {
    // 获取当前 Go 文件所在目录（即 hello/）
    exePath, err := os.Executable()
    if err != nil {
        return nil, fmt.Errorf("failed to get executable path: %w", err)
    }
    dir := filepath.Dir(exePath) // 或使用 os.Getwd() 获取运行时工作目录

    // 构建 hello.sh 的绝对路径
    scriptPath := filepath.Join(dir, "hello.sh")

    // 执行脚本（注意：/bin/sh 是解释器，scriptPath 是参数）
    cmd := exec.Command("/bin/sh", scriptPath)

    // 捕获标准输出和标准错误
    out, err := cmd.Output()
    if err != nil {
        // exit status 127 通常意味着脚本路径错误或 /bin/sh 找不到该文件
        if exitErr, ok := err.(*exec.ExitError); ok {
            log.Printf("Script failed with exit code %d, stderr: %s", 
                exitErr.ExitCode(), string(exitErr.Stderr))
        }
        return nil, fmt.Errorf("failed to run hello.sh: %w", err)
    }
    return out, nil
}

func main() {
    output, err := runHelloScript()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Script output: %s", output) // 期望输出类似 ["a", "b", "c"]
}

? 提示：若 hello.sh 内容为 echo '["a", "b", "c"]'，上述代码将准确打印该 JSON 字符串。

⚠️ 关键注意事项

不要省略路径：exec.Command("/bin/sh", "hello.sh") 中 "hello.sh" 是相对路径，其解析依赖于 cmd.Dir（默认为当前工作目录）。建议显式设置 cmd.Dir = dir 或直接传入绝对路径，避免歧义。
区分 Run()、Output() 和 CombinedOutput()：
- Run()：仅等待执行完成，不返回输出；
- Output()：返回 stdout，若命令失败则 err 非空（stderr 不包含在返回值中）；
- CombinedOutput()：合并 stdout 和 stderr，适合调试。
权限与 Shell 特性：Go 不通过 shell 解析命令（如 exec.Command("ls *.go") 不会通配展开），因此调用脚本时必须显式指定解释器（如 /bin/sh）且脚本需有 +x 权限。
安全性提醒：避免拼接用户输入到命令参数中，防止命令注入；如需动态参数，请使用 exec.Command 的多参数形式（而非 shell -c "..."）。