Go exec.Cmd 怎样给子进程传额外文件描述符

Go 的 exec.Cmd 要把父进程已经打开的管道、套接字或其他文件传给子进程，可以使用 ExtraFiles。最容易记错的一条规则是：ExtraFiles[i] 在子进程中对应的不是父进程原来的文件描述符，而是从 3+i 开始重新编号。因此 ExtraFiles[0] 是子进程的 fd 3，ExtraFiles[1] 是 fd 4。

只要父进程把文件放在 ExtraFiles 的正确位置，子进程就按固定的 fd 3、fd 4 读取。父进程原始 fd 是多少，不会改变这个位置映射。

本文只讨论编号和最小传递配方。Go 官方 os/exec 文档说明，ExtraFiles 不包含标准输入、标准输出和标准错误，而且当前不支持 Windows；下面的示例因此按 Unix-like 环境组织。

ExtraFiles 的编号从哪里开始

一个新进程通常把标准输入、标准输出和标准错误分别放在 fd 0、fd 1、fd 2。Cmd.ExtraFiles 会把额外文件接在这三个标准描述符之后，切片下标与子进程编号之间的关系可以写成：

子进程文件描述符 = 3 + ExtraFiles 切片下标

ExtraFiles[0] -> fd 3
ExtraFiles[1] -> fd 4
ExtraFiles[2] -> fd 5

这里的“第几个”指的是切片位置，不是父进程调用 os.Open 或 os.Pipe 后拿到的整数。即使父进程手里的文件恰好是 fd 7，只要它放在 ExtraFiles[0]，子进程仍然按 fd 3 获取它。

最小配方：用管道把数据交给子进程

为了让编号关系清楚，可以让同一个 Go 程序通过参数区分父进程和子进程。父进程创建管道，把读取端放到 ExtraFiles[0]，再通过标准输入以外的 fd 3 交给子进程；子进程调用 os.NewFile(3, ...) 取回这个继承的文件。

package main

import (
	"fmt"
	"io"
	"os"
	"os/exec"
)

func main() {
	if len(os.Args) > 1 && os.Args[1] == "--child" {
		runChild()
		return
	}

	// 管道的读取端会放入 ExtraFiles[0]，因此子进程中固定是 fd 3。
	readEnd, writeEnd, err := os.Pipe()
	if err != nil {
		panic(err)
	}
	defer readEnd.Close()

	cmd := exec.Command(os.Args[0], "--child")
	cmd.ExtraFiles = []*os.File{readEnd}

	// 父进程写完后关闭写端，避免子进程一直等不到 EOF。
	if err := cmd.Start(); err != nil {
		writeEnd.Close()
		panic(err)
	}
	if _, err := writeEnd.WriteString("来自父进程的消息"); err != nil {
		writeEnd.Close()
		panic(err)
	}
	writeEnd.Close()

	// Start 成功后再等待，子进程会从 fd 3 读取管道内容。
	if err := cmd.Wait(); err != nil {
		panic(err)
	}
}

func runChild() {
	// ExtraFiles[0] 在子进程中就是 fd 3，不要使用父进程的原始编号。
	readEnd := os.NewFile(uintptr(3), "inherited-pipe")
	if readEnd == nil {
		fmt.Fprintln(os.Stderr, "无法创建 fd 3")
		os.Exit(1)
	}
	defer readEnd.Close()

	data, err := io.ReadAll(readEnd)
	if err != nil {
		fmt.Fprintln(os.Stderr, "读取 fd 3 失败:", err)
		os.Exit(1)
	}
	fmt.Println(string(data))
}

这段代码的关键不在于管道本身，而在于两侧约定一致：父进程把 readEnd 放到切片第 0 项，子进程就从 3 取；父进程保留 writeEnd 用来发送数据。父进程关闭写端后，子进程才能在数据读完时观察到 EOF。

父进程原始 fd 不决定子进程编号

文件描述符是进程自己的编号空间。父进程可以先打开很多文件，让管道或套接字拿到一个较大的 fd；只要它被放进 ExtraFiles[0]，子进程仍会把它看成 fd 3。这个特性适合把“父进程资源”转换成“子进程约定好的入口”。

如果需要传两个资源，可以把它们放在两个位置，并让子进程固定读取 fd 3 和 fd 4：

// 位置决定子进程编号：第 0 项是 fd 3，第 1 项是 fd 4。
cmd.ExtraFiles = []*os.File{pipeRead, socketFile}

// 子进程按父进程约定好的编号获取两个资源。
pipeRead := os.NewFile(uintptr(3), "pipe")
socketFile := os.NewFile(uintptr(4), "socket")

示例中的 socketFile 只表示一个已经打开、可继承的文件对象；具体套接字的创建、协议和读写方式不在本文范围内。真正的程序应把 fd 3、fd 4 这样的约定写进父子进程的接口说明，避免双方各自猜测。

关闭时机和空位怎么处理

使用 ExtraFiles 时，最常见的资源问题有三个。第一，父进程启动成功后仍然持有不需要的读取端，可能让子进程迟迟收不到 EOF；第二，父进程过早关闭传给子进程的文件，导致子进程读取失败；第三，把文件放进切片后又改变切片顺序，却没有同步修改子进程的编号约定。

• 调用 cmd.Start() 成功后，父进程只保留自己还要使用的一端，传给子进程的那一端由子进程负责关闭。
• 使用管道时，写入完成后及时关闭写端；否则子进程的 io.ReadAll 可能一直等待。
• 多个文件按固定顺序组成切片，切片顺序就是协议的一部分，不要用父进程原始 fd 作为数组下标。
• 如果某个位置暂时没有资源，不要随意放入 nil 期待它占位；应重新设计紧凑的切片和子进程协议。

遇到“读不到 fd 3”时先查这几个点

把 ExtraFiles[0] 错写成 fd 0 了吗？

fd 0 是标准输入，ExtraFiles[0] 从 fd 3 开始。子进程若从 fd 0 读，读到的是标准输入，而不是额外传入的文件。

父进程的 fd 是 7，子进程也应该读 7 吗？

不应该。父进程的原始编号不参与 ExtraFiles 的位置映射。只要资源在 ExtraFiles[0]，子进程就应按 fd 3 读取。

Windows 上为什么同样的代码不工作？

Go 官方文档明确说明 Cmd.ExtraFiles 不支持 Windows。如果程序需要跨平台传递数据，应考虑标准输入输出、临时文件、网络连接或其他跨平台 IPC 方案，并为不同平台分别设计资源交接方式。

传多个文件时怎样保证编号不乱？

在父子进程协议中固定声明“切片第 0 项是管道，第 1 项是套接字”，子进程对应读取 fd 3 和 fd 4。变更资源顺序时，同时修改两侧协议和测试用例。

小结

ExtraFiles 的规则可以压缩成一句话：它不包含 0、1、2 三个标准描述符，切片第 i 项在子进程中从 fd 3+i 开始。把父进程文件放进正确位置、让子进程按固定编号读取、并在合适时机关闭不再使用的端点，就能稳定地传递管道或套接字。