在Go语言开发中，调用外部命令是处理系统交互、执行第三方工具任务的常见需求，标准库中的os/exec包提供了完整的外部命令调用能力，支持同步执行、异步执行、参数传递、输出捕获等多种场景。
os/exec包核心类型说明
os/exec包中两个核心类型是实现外部命令调用的基础，先了解它们的作用：
- exec.Cmd：代表一个准备执行或正在执行的外部命令，包含命令路径、参数、环境变量、输入输出配置等所有执行相关的信息。
- exec.Error：命令执行过程中出现的错误类型，比如命令不存在、无法启动等情况会返回该错误。
基础外部命令调用方法
1. 简单命令执行（无参数、不捕获输出）
如果只是需要执行一个简单命令，不需要获取输出，也不关心执行结果，可以使用exec.Command配合Run方法实现：
package main
import (
"fmt"
"os/exec"
)
func main() {
// 调用系统ls命令，列出当前目录内容
cmd := exec.Command("ls")
// 执行命令，等待命令完成
err := cmd.Run()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
return
}
fmt.Println("命令执行成功")
}
2. 带参数的命令执行
大部分外部命令都需要传递参数，参数需要作为exec.Command的后续参数传入，第一个参数是命令名称，后面的参数按顺序传入：
package main
import (
"fmt"
"os/exec"
)
func main() {
// 调用ls命令，传递-l和-a两个参数
cmd := exec.Command("ls", "-l", "-a")
err := cmd.Run()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
return
}
}
注意不要在命令字符串中拼接参数，比如exec.Command("ls -l -a")是错误的写法，会导致命令无法正确解析。
捕获命令执行结果
1. 捕获标准输出
如果需要获取命令执行后的标准输出内容，可以使用Output方法，该方法会执行命令并返回标准输出的字节切片：
package main
import (
"fmt"
"os/exec"
)
func main() {
// 调用echo命令输出一段文本
cmd := exec.Command("echo", "Hello Go External Command")
// 获取标准输出
output, err := cmd.Output()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
return
}
// 将字节切片转换为字符串打印
fmt.Printf("命令输出内容: %sn", output)
}
2. 同时捕获标准输出和标准错误
如果还需要获取命令的标准错误输出，可以使用CombinedOutput方法，该方法会把标准输出和标准错误合并返回：
package main
import (
"fmt"
"os/exec"
)
func main() {
// 调用一个不存在的命令，触发错误
cmd := exec.Command("not_exist_cmd")
output, err := cmd.CombinedOutput()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
fmt.Printf("错误输出内容: %sn", output)
return
}
fmt.Printf("命令输出内容: %sn", output)
}
3. 获取退出状态码
命令执行失败可能是返回了非0的退出状态码，可以通过类型断言获取具体的退出状态码：
package main
import (
"fmt"
"os/exec"
"syscall"
)
func main() {
cmd := exec.Command("ls", "not_exist_file")
err := cmd.Run()
if err != nil {
// 判断是否为退出错误
if exitErr, ok := err.(*exec.ExitError); ok {
// 获取退出状态码，不同系统获取方式略有差异
if status, ok := exitErr.Sys().(syscall.WaitStatus); ok {
fmt.Printf("命令退出状态码: %dn", status.ExitStatus())
}
} else {
fmt.Printf("命令执行出错: %vn", err)
}
return
}
}
高级使用场景
1. 命令执行超时控制
如果外部命令执行时间过长，需要设置超时时间避免程序阻塞，可以结合context包实现：
package main
import (
"context"
"fmt"
"os/exec"
"time"
)
func main() {
// 创建超时时间为3秒的上下文
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
cmd := exec.CommandContext(ctx, "sleep", "5")
err := cmd.Run()
if err != nil {
fmt.Printf("命令执行结果: %vn", err)
// 判断是否为超时错误
if ctx.Err() == context.DeadlineExceeded {
fmt.Println("命令执行超时")
}
return
}
fmt.Println("命令执行完成")
}
2. 自定义环境变量
如果需要为执行的外部命令设置自定义的环境变量，可以修改Cmd的Env字段：
package main
import (
"fmt"
"os"
"os/exec"
)
func main() {
cmd := exec.Command("printenv", "MY_CUSTOM_VAR")
// 获取当前系统的环境变量
currentEnv := os.Environ()
// 添加新的环境变量
cmd.Env = append(currentEnv, "MY_CUSTOM_VAR=test_value")
output, err := cmd.Output()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
return
}
fmt.Printf("自定义环境变量值: %sn", output)
}
3. 异步执行命令
如果不需要等待命令执行完成，可以先调用Start方法启动命令，后续再通过Wait方法等待完成：
package main
import (
"fmt"
"os/exec"
)
func main() {
cmd := exec.Command("sleep", "2")
// 启动命令，不等待完成
err := cmd.Start()
if err != nil {
fmt.Printf("命令启动失败: %vn", err)
return
}
fmt.Println("命令已启动，正在后台执行")
// 做其他事情
fmt.Println("执行其他逻辑")
// 等待命令完成
err = cmd.Wait()
if err != nil {
fmt.Printf("命令执行失败: %vn", err)
return
}
fmt.Println("后台命令执行完成")
}
注意事项
- 调用外部命令时要注意命令的跨平台兼容性，比如Windows系统下没有ls命令，需要使用dir命令替代。
- 不要直接拼接用户输入作为命令参数，避免命令注入风险，所有参数都通过
exec.Command的参数列表传入。 - 如果命令需要交互式输入，需要配置
Cmd的Stdin字段，向命令写入输入内容。