本文详解 Go 中 exec.Command 无法直接支持 shell 通配符（如 *.json）的原因，演示如何获取完整的命令错误信息，并提供安全、可靠、跨平台的文件/目录复制方案。
本文详解 go 中 `exec.command` 无法直接支持 shell 通配符（如 `*.json`）的原因，演示如何获取完整的命令错误信息，并提供安全、可靠、跨平台的文件/目录复制方案。
在 Go 中调用系统命令（如 cp -r ./*.json dest/）时遇到 exit status 1 却无法获知具体失败原因，是初学者常见痛点。根本原因在于：exec.Command 不经过 shell 解析，因此不支持通配符展开（globbing）、管道、重定向等 shell 特性。你传入的 "./*.json" 会被字面量传递给 cp 命令，而 cp 在当前目录下找不到名为字面量 *.json 的文件（非通配匹配），于是报错退出。
? 如何获取完整的错误详情？
cmd.Output() 在失败时返回的 err 是 *exec.ExitError 类型，它包含标准错误输出（stderr）。应使用 cmd.CombinedOutput() 或分别捕获 stdout/stderr：
func ExecuteCommandWithOutput(cmd *exec.Cmd) error {
var stdout, stderr bytes.Buffer
cmd.Stdout = &stdout
cmd.Stderr = &stderr
err := cmd.Run() // 使用 Run() 而非 Output()，避免隐藏 stderr
if err != nil {
if exitErr, ok := err.(*exec.ExitError); ok {
log.Printf("Command failed: %v\nStdout: %s\nStderr: %s",
cmd.Args, stdout.String(), stderr.String())
} else {
log.Printf("Execution error: %v", err)
}
return err
}
fmt.Print("Output: ", stdout.String())
return nil
}✅ 提示：
cmd.Output()仅返回 stdout，且对非零退出码会返回包装后的exec.ExitError，但其Error()方法默认不打印 stderr 内容——必须显式读取stderr缓冲区才能看到真实错误（例如cp: cannot stat '*.json': No such file or directory）。
❌ 为什么 exec.Command("cp", "-r", "./*.json", dst) 不工作？
-
exec.Command直接调用二进制程序（/bin/cp），不调用/bin/sh -c； -
*.json未被 shell 展开，cp收到的是字面字符串"./*.json"，而非匹配到的实际 JSON 文件列表； - 此行为与
bash -c 'cp -r ./*.json dst'完全不同，后者由 shell 完成 glob 扩展。
✅ 推荐方案：使用 Go 原生方式实现复制（推荐 ✅）
避免依赖外部命令，提升可移植性（Windows/macOS/Linux 一致）和安全性：
import (
"io"
"os"
"path/filepath"
)
// CopyFile 复制单个文件
func CopyFile(src, dst string) error {
in, err := os.Open(src)
if err != nil {
return err
}
defer in.Close()
out, err := os.Create(dst)
if err != nil {
return err
}
defer out.Close()
_, err = io.Copy(out, in)
return err
}
// CopyDir 递归复制目录（含子目录与文件）
func CopyDir(src, dst string) error {
entries, err := os.ReadDir(src)
if err != nil {
return err
}
if err := os.MkdirAll(dst, 0755); err != nil {
return err
}
for _, entry := range entries {
srcPath := filepath.Join(src, entry.Name())
dstPath := filepath.Join(dst, entry.Name())
if entry.IsDir() {
if err := CopyDir(srcPath, dstPath); err != nil {
return err
}
} else if filepath.Ext(entry.Name()) == ".json" { // ✅ 按扩展名过滤
if err := CopyFile(srcPath, dstPath); err != nil {
return err
}
}
}
return nil
}
// 使用示例
err := CopyDir(".", filepath.Join(artifact.dir, "json-files"))
if err != nil {
log.Fatal("Copy failed:", err)
}? 进阶建议
- 若需高性能大批量复制，可考虑
github.com/otiai10/copy（成熟、健壮、支持过滤与进度）； - 若坚持使用
cp（如需硬链接、ACL 等高级特性），请改用sh -c显式调用 shell：cmd := exec.Command("sh", "-c", "cp -r ./*.json "+shellQuote(artifact.dir))⚠️ 注意：务必对路径做
shellQuote（如shellescape.Quote）防止命令注入。
✅ 总结
| 方案 | 是否支持通配符 | 跨平台 | 错误可见性 | 推荐度 |
|---|---|---|---|---|
exec.Command("cp", ...) |
❌（需手动 glob） | ❌（Linux/macOS） | ⚠️ 需手动捕获 stderr | ⚠️ 仅限简单脚本 |
exec.Command("sh", "-c", "cp ...") |
✅ | ⚠️（Windows 无 sh） | ✅（结合 CombinedOutput） | ⚠️ 需防注入 |
纯 Go 实现（os, io, filepath） |
✅（代码中灵活过滤） | ✅ | ✅（原生 error） | ✅✅✅ 强烈推荐 |
拥抱 Go 的标准库，让复制逻辑更可控、更健壮、更易测试——这才是地道的 Go 之道。
