go os/exec 简明教程_go语言os包
liuian 2025-09-03 03:30 24 浏览
Go标准库提供了便利的方法,可以很容易地运行外部命令,一般我们会使用os/exec包下的方法实现执行外部命令以及和外部命令交互。os/exec包装了os.StartProcess方法,更方便的进行输入和输出的访问,提供I/O pipe等功能。我会通过两篇文章专门介绍Go启动新进程,执行外部命令的方法,这是第一篇,专门介绍os/exec库。
os/exec库提供方法和POSIX标准中定义的C语言的方法类似,但是提供了进一步的封装,更方便使用。接下来我会一一给你介绍。
运行一个命令
最简单的运行一个外部命令的方式就是调用Command方法,你需要传入要执行的程序和参数,它会返回一个*Cmd的数据结构,代表了一个执行的外部命令,主要调用它的Run、Output、CombinedOutput方法后这个对象就不能重用了,一般我们也不会重用这个对象,而是在需要的时候新生成一个。
下面这段代码就是执行ls命令,并传给它参数-lah。
cmd := exec.Command("ls", "-lah")
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}如果你执行这个命令,控制台中并没有任何输出,其实这个命令已经执行了,只不过我们的Go程序并没有捕获和处理输出,所以控制台中并没有任何输出。
Run方法会执行外部命令并等待命令完成,如果命令正常执行,没有错误,返回码为0,那么Run返回的err == nil,那么返回一个*ExitError,有时候你需要读取cmd.Stdout甚至cmd.Stderr以便获取详细的错误信息。
如果你不想等待,那么可以调用Start方法,如果Start成功,Process和ProcessState字段会被设置。你可以检查ProcessState.Exited()判断程序是否退出。如果你想再阻塞等待程序的完成,你可以调用Wait方法。
事实上,Run方法就是利用Start方法和Wait方法实现的:
func (c *Cmd) Run() error {
if err := c.Start(); err != nil {
return err
}
return c.Wait()
}显示外部命令的输出
Cmd命令包含输入和输出字段,你可以设置这些字段,实现定制输入和输出:
Stdin io.Reader
Stdout io.Writer
Stderr io.Writer
如果Stdin为空,那么进程会从null device(os.DevNull)中读取。
如果Stdin是*os.File对象,那么会从这个文件中读取。
如果Stdin是os.Stdin,那么会从标准输入比如命令行中读取数据。
Stdout和Stderr代表外部程序进程的标准输出和错误输出,如果为空,那么输出到null device中。
如果Stdout和Stderr是*os.File对象,那么会往文件中输出数据。
如果Stdout和Stderr分别设置为os.Stdout、os.Stderr的话,会输出到命令行中。
我们改造上一个例子,显示命令输出结果:
cmd := exec.Command("ls", "-lah")
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}工作路径
默认情况下进程的工作路径是调用这个进程的文件夹,但是你也可以手工指定,比如我们将工作路径指定为根路径:
cmd := exec.Command("ls", "-lah")
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
cmd.Dir = "/"
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}外部程序path
Cmd.Path是要执行的程序的路径,如果是相对路径,那么它基于Cmd.Dir计算相对路径。如果程序已经在系统$PATH路径下,那么可以直接写程序名。
cmd := exec.Command("/usr/local/go/bin/go", "env")
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
log.Printf("path: %s", cmd.Path)
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}设置环境变量
Cmd还有一个字段叫做Env,用来设置进程的环境变量,格式是key=value。
如果Env为空,那么新进程将使用调用者进程的环境变量。
比如下面的例子,我们设置了myvar变量,你可以注释掉cmd.Enc = ...那一行比较一下结果。
cmd := exec.Command("bash", "-c", "echo $myvar")
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
cmd.Env = []string{"myvar=abc"}
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}底层的Process和ProcessState
在上面我提到过,os/exec是封装的一个便利库,底层它是使用os.StartProcess实现的,所以你可以得到底层的Process对象和ProcessState对象,分别代表进程和进程的状态。
cmd := exec.Command("bash", "-c", "sleep 1;echo $myvar")
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
err := cmd.Start()
if err != nil {
log.Fatalf("failed to call cmd.Start(): %v", err)
}
log.Printf("pid: %d", cmd.Process.Pid)
cmd.Process.Wait()
log.Printf("exitcode: %d", cmd.ProcessState.ExitCode())判断外部命令是否存在
有时候,你需要在执行一个外部命令的时候需要先检查它是否存在,你可以使用LookPath方法。
如果传入参数包含路径分隔符,那么它会基于Cmd.Dir的相对路径或者绝对路径查找这个程序。如果不包含路径分隔符,那么会从PATH环境变量中查找文件。
path, err := exec.LookPath("ls")
if err != nil {
log.Printf("'ls' not found")
} else {
log.Printf("'ls' is in '%s'\n", path)
}获取命令结果
Cmd提供了Output()方法,如果命令正确执行,可以得到命令执行结果的bytes:
cmd := exec.Command("ls", "-lah")
data, err := cmd.Output()
if err != nil {
log.Fatalf("failed to call Output(): %v", err)
}
log.Printf("output: %s", data)如果命令出错,错误信息可以通过Stderr获得:
cmd := exec.Command("ls", "-lahxyz")
cmd.Stderr = os.Stderr
data, err := cmd.Output()
if err != nil {
log.Fatalf("failed to call Output(): %v", err)
}
log.Printf("output: %s", data)组合Stdout和Stderr
如果你想不管出错与否都能一个方法获取输出结果的话,你可以调用CombinedOutput()方法,它会返回正常输出或者错误输出,并且第二个返回err可以指示是否执行出错:
cmd := exec.Command("ls", "-lah")
data, err := cmd.CombinedOutput()
if err != nil {
log.Fatalf("failed to call CombinedOutput(): %v", err)
}
log.Printf("output: %s", data)CombinedOutput方法的实现也很简单,其实就是共享同一个bytes.Buffer实现的。
func (c *Cmd) CombinedOutput() ([]byte, error) {
if c.Stdout != nil {
return nil, errors.New("exec: Stdout already set")
}
if c.Stderr != nil {
return nil, errors.New("exec: Stderr already set")
}
var b bytes.Buffer
c.Stdout = &b
c.Stderr = &b
err := c.Run()
return b.Bytes(), err
}分别读取Stdout和Stderr
了解了CombinedOutput的实现,我们就可以为Stdout和Stderr分别设置bytes.Buffer,来实现独立的读取。
cmd := exec.Command("ls", "-lah")
var stdout, stderr bytes.Buffer
cmd.Stdout = &stdout
cmd.Stderr = &stderr
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call Run(): %v", err)
}
log.Printf("out:\n%s\nerr:\n%s", stdout.String(), stderr.String())显示命令执行进度
既然我们已经能够使用自己的io.Writer设置Stdout/Stderr,那么我们可以做更丰富的功能。
比如利用curl命令下载一个大的文件,我们可以实时的显示已下载的数据的大小。
cmd := exec.Command("curl", "https://dl.google.com/go/go1.15.6.linux-amd64.tar.gz")
var stdoutProcessStatus bytes.Buffer
cmd.Stdout = io.MultiWriter(ioutil.Discard, &stdoutProcessStatus)
done := make(chan struct{})
go func() {
tick := time.NewTicker(time.Second)
defer tick.Stop()
for {
select {
case <-done:
return
case <-tick.C:
log.Printf("downloaded: %d", stdoutProcessStatus.Len())
}
}
}()
err := cmd.Run()
if err != nil {
log.Fatalf("failed to call Run(): %v", err)
}
close(done)设置Stdin
前面几个例子都是演示处理Output的情况,接下来这个例子演示了如何设置Stdin。
wc命令读取main.go文件,统计它一共有多少行。
stdin, err := os.Open("main.go")
if err != nil {
log.Fatalf("failed to open file: %v", err)
}
cmd := exec.Command("wc", "-l")
cmd.Stdin = stdin
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
err = cmd.Run()
if err != nil {
log.Fatalf("failed to call cmd.Run(): %v", err)
}Pipe
你可以将一个命令的输出作为下一个命令的输入,以此类推,将多个命令串成一个管道。
os/exec提供了StderrPipe、StdinPipe、StdoutPipe方法,获取管道对象。
比如下面的命令,将cat main.go的输出作为wc -l命令的输入:
cmdCat := exec.Command("cat", "main.go")
catout, err := cmdCat.StdoutPipe()
if err != nil {
log.Fatalf("failed to get StdoutPipe of cat: %v", err)
}
cmdWC := exec.Command("wc", "-l")
cmdWC.Stdin = catout
cmdWC.Stdout = os.Stdout
err = cmdCat.Start()
if err != nil {
log.Fatalf("failed to call cmdCat.Run(): %v", err)
}
err = cmdWC.Start()
if err != nil {
log.Fatalf("failed to call cmdWC.Start(): %v", err)
}
cmdCat.Wait()
cmdWC.Wait()首先将管道创建好,然后依次调用各命令的Start方法和Wait方法。
通用的Pipe方法
下面是一个更通用的创建Cmd管道的方法:
func main() {
cmdCat := exec.Command("cat", "main.go")
cmdWC := exec.Command("wc", "-l")
data, err := pipeCommands(cmdCat, cmdWC)
if err != nil {
log.Fatalf("failed to call pipeCommands(): %v", err)
}
log.Printf("output: %s", data)
}
func pipeCommands(commands ...*exec.Cmd) ([]byte, error) {
for i, command := range commands[:len(commands)-1] {
out, err := command.StdoutPipe()
if err != nil {
return nil, err
}
command.Start()
commands[i+1].Stdin = out
}
final, err := commands[len(commands)-1].Output()
if err != nil {
return nil, err
}
return final, nil
}bash pipe
如果你通过bash命令执行,你可以使用bash pipe的功能,写起来更简单。
cmd := exec.Command("bash", "-c", "cat main.go| wc -l")
data, err := cmd.CombinedOutput()
if err != nil {
log.Fatalf("failed to call pipeCommands(): %v", err)
}
log.Printf("output: %s", data)孤儿进程
当子进程还没有结束的时候,父进程先结束了,那么此时的子进程就叫做孤儿进程,这个时候子进程的ppid就被设置为了1。
cmd := exec.Command("curl", "-o", "go1.15.6.linux-amd64.tar.gz", "https://dl.google.com/go/go1.15.6.linux-amd64.tar.gz")
err := cmd.Start()
if err != nil {
log.Fatalf("failed to call Run(): %v", err)
}当主程序退出时,这个curl子进程还会一直下载,它的ppid被设置为了1,你可以使用ps查看进程信息,比如在Mac中:
ps xao pid,ppid,pgid,sid,comm | grep curl
程序退出时Kill子进程
如果我们想在程序退出的时候Kill掉它启动的子进程,那么一个比较笨的办法就是得到子进程的 Process对象,然后调用它的Kill方法将其杀掉。但比较遗憾的是它不能把孙进程杀掉。
对于Linux系统,你可以通过下面的设置将孙进程也杀掉:
cmd := exec.Command("curl", "-o", "go1.15.6.linux-amd64.tar.gz", "https://dl.google.com/go/go1.15.6.linux-amd64.tar.gz")
cmd.SysProcAttr = &syscall.SysProcAttr{Pdeathsig: syscall.SIGKILL}
err := cmd.Start()
if err != nil {
log.Fatalf("failed to call Run(): %v", err)
}或者更通用的使用下面的设置:
cmd := exec.Command("curl", "-o", "go1.15.6.linux-amd64.tar.gz", "https://dl.google.com/go/go1.15.6.linux-amd64.tar.gz")
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}
err := cmd.Start()
if err != nil {
log.Fatalf("failed to call Run(): %v", err)
}see https://groups.google.com/g/golang-nuts/c/XoQ3RhFBJl8
将父进程打开的文件传给子进程
除了标准输入输出0,1,2三个文件外,你还可以将父进程的文件传给子进程,通过Cmd.ExtraFiles字段就可以。
比较常用的一个场景就是graceful restart,新的进程继承了老的进程监听的net.Listener,这样网络连接就不需要关闭重打开了。
比如最早介绍go graceful restart技术的文章之一Graceful Restart in Golang的代码:
file := netListener.File() // this returns a Dup()
path := "/path/to/executable"
args := []string{
"-graceful"}
cmd := exec.Command(path, args...)
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
cmd.ExtraFiles = []*os.File{file}
err := cmd.Start()
if err != nil {
log.Fatalf("gracefulRestart: Failed to launch, error: %v", err)
}文章来源:
https://colobu.com/2020/12/27/go-with-os-exec/
相关推荐
- 系统还原没有还原点怎么办(系统还原点不动怎么办)
-
如果电脑没有创建还原点,就不能使用系统还原来回到之前的状态。但是,可以尝试使用其他备份工具或软件来恢复数据或重建系统。比如,可以使用第三方备份软件来备份重要文件和数据。如果是系统出现问题,可以尝试重新...
- 正在准备windows(正在准备windows请勿关机怎么办)
-
这个情况在使用华为电脑时可能会遇到。一般来说,这是因为电脑正在进行系统更新或者安装软件程序等操作,导致启动时间较长。如果电脑显示“正在准备Windows,请勿关闭电源”,则说明电脑正在进行系统更新。...
-
- 有win10安装包怎么装系统(win10安装包安装教程)
-
如果是原版ISO镜像,可以加载到虚拟光驱直接安装。如果是第三方更改的就需要启动盘。个人建议用U盘启动盘来安装。下载一个u盘启动盘程序(优启通、大白菜……),按照提示把它安装到U盘。启动盘制作完毕以后,启动电脑安快捷键选择U盘启动。进入pe后...
-
2026-01-14 16:37 liuian
- gho怎么变成iso文件(gho改成iso)
-
要将GHO转换为ISO,您需要使用GHO映像转换器软件。以下是执行此操作的步骤:1.下载和安装GHO映像转换器软件。2.运行转换器软件,并单击“打开”按钮。3.在弹出窗口中,选择要转换的GHO...
- office和visio安装顺序(office和visio怎么一起安装)
-
在某些情况下,安装Visio可能会发生与Office365冲突的问题。这是因为Visio和Office365具有不同的版本,可能会导致安装时出现错误或兼容性问题。为了避免这种冲突,...
- 电脑中病毒的原因(电脑中病毒正常吗)
-
电脑中毒的原因有以下几方面:1.网页被挂病毒。2.电脑裸奔,无防病毒软件。3.执行一些不安全的程序。4.U盘等不安全介质。5.电脑漏洞不及时补,被后台种毒。为了电脑不中病毒要注意以下几方面:1.更新系...
- 手机psd转换成jpg最简单方式
-
可以使用photoshop工具,方法如下:1、首先打开PS软件,然后选择自己需要的JPG格式的图片,在PS中打开。2、接下来先按快捷键“Ctrl+j”将图片复制出来,防止后面操作对原图片有损...
- win7提示激活码过期怎么办(win7激活已过期)
-
以win7为例,出现这样的问题原因分析:电脑的win7系统激活过又重新提示要激活的原因是因为微软对网络上的秘钥进行封杀所以导致我们激活无效。具体的解决方法:1、我们打开dos命令窗口,在创立中输入“s...
- 联想笔记本光驱驱动下载(联想电脑光驱驱动器在哪)
-
开机时进入BIOS,具体按什么牌子不同,按键也不同,开机有提示的,选择启动项,把光驱启动的顺序放到第一.按F10保存,重新启动就是光驱启动啦不需要设置光驱驱动,笔记本自带光驱驱动光驱是电脑的硬件设备,...
- win10装机必备实用软件(win10电脑装机必备软件)
-
1、office大部分的版本如office2007、office2000、office2011、office2013、office2016、office365等都支持win10。2、需要注意...
- 迅雷无法下载的链接用什么下载
-
1.可以使用其他下载工具代替迅雷。2.迅雷可能无法下载的原因有很多,比如网络问题、软件故障等。其他下载工具可以提供类似的功能,但可能具有更好的稳定性和兼容性。3.一些常见的替代迅雷的下载工具包括...
- apple官方网站(apple官方网站旗舰店)
-
1、首先打开浏览器,输入https://www.apple.com/;2、即可浏览苹果官网。 苹果公司(AppleInc.)是美国一家高科技公司。由史蒂夫·乔布斯、斯蒂夫·沃兹尼亚克和罗·韦恩(R...
- 哪些手机用鸿蒙系统(都什么手机能用鸿蒙系统)
-
截至目前,国内有以下几款手机品牌可以装鸿蒙系统:1.华为:华为Mate40系列、P40系列、Mate30系列、MatePadPro系列等。2.荣耀:荣耀V40、荣耀30系列、荣耀X10系列等...
- 一周热门
-
-
飞牛OS入门安装遇到问题,如何解决?
-
如何在 iPhone 和 Android 上恢复已删除的抖音消息
-
Boost高性能并发无锁队列指南:boost::lockfree::queue
-
大模型手册: 保姆级用CherryStudio知识库
-
用什么工具在Win中查看8G大的log文件?
-
如何在 Windows 10 或 11 上通过命令行安装 Node.js 和 NPM
-
威联通NAS安装阿里云盘WebDAV服务并添加到Infuse
-
Trae IDE 如何与 GitHub 无缝对接?
-
idea插件之maven search(工欲善其事,必先利其器)
-
如何修改图片拍摄日期?快速修改图片拍摄日期的6种方法
-
- 最近发表
- 标签列表
-
- python判断字典是否为空 (50)
- crontab每周一执行 (48)
- aes和des区别 (43)
- bash脚本和shell脚本的区别 (35)
- canvas库 (33)
- dataframe筛选满足条件的行 (35)
- gitlab日志 (33)
- lua xpcall (36)
- blob转json (33)
- python判断是否在列表中 (34)
- python html转pdf (36)
- 安装指定版本npm (37)
- idea搜索jar包内容 (33)
- css鼠标悬停出现隐藏的文字 (34)
- linux nacos启动命令 (33)
- gitlab 日志 (36)
- adb pull (37)
- python判断元素在不在列表里 (34)
- python 字典删除元素 (34)
- vscode切换git分支 (35)
- python bytes转16进制 (35)
- grep前后几行 (34)
- hashmap转list (35)
- c++ 字符串查找 (35)
- mysql刷新权限 (34)
