Go syscall.Exec 怎样替换当前进程

我第一次在 Go 里做“把当前服务交给另一个程序继续运行”时，差点把 syscall.Exec 当成了更底层的 exec.Command。两者的结果完全不同：前者成功后会用目标程序替换当前进程映像，后者通常是保留父进程、再启动一个子进程。

本文只讨论参数、环境和进程替换结果。官方资料：https://pkg.go.dev/syscall、https://go.dev/src/syscall/exec_unix.go、https://pkg.go.dev/os/exec。

syscall.Exec 的调用重点不是“再启动一个程序”，而是把 argv0、argv、envv 一次准备正确。成功时当前 Go 代码不会继续往下执行；只有系统调用失败，才会返回 error。

先分清子进程和当前进程替换

os/exec.Command 适合让 Go 程序管理一个外部命令：父进程还在，可以等待、读取输出或继续处理请求。syscall.Exec 对应 Unix 的 execve 语义，进程 ID 通常保持不变，但原来的 Go 程序映像被目标可执行文件替换。

这意味着调用后的代码不能承担“成功后的清理”或“继续响应请求”。需要记录诊断信息、写入审计日志或确认参数的动作，都应该放在调用前；如果调用失败，再根据返回的错误决定退出或回退。

syscall.Exec 的参数为什么必须同时准备好

官方签名是 Exec(argv0 string, argv []string, envv []string) error。第一个参数是要执行的文件路径；argv 是新程序看到的参数数组，数组第一个元素通常仍然要放程序名；envv 是形如 KEY=value 的环境数组。

我觉得最容易踩的坑是把 argv0 当成了“自动补到 argv 的路径”。它们是两个独立输入：路径用于找到要替换的可执行文件，而 argv[0] 是目标程序看到的命令名。环境数组也不是增量字典，若只传一组新变量，就不会自动保留当前进程的全部环境。

用最小代码准备路径、参数和环境

下面示例把当前环境复制一份，再追加一个变量；这样写的目的不是演示业务逻辑，而是把三组输入的职责拆开。示例只针对 Unix 类系统，跨平台项目应把它放在对应的构建文件中。

package main

import (
	"fmt"
	"os"
	"syscall"
)

func main() {
	// argv0 是目标可执行文件的路径，示例使用系统中常见的 shell。
	argv0 := "/bin/sh"
	argv := []string{"sh", "-c", "printf 'mode=%s\\n' \"$APP_MODE\""}

	// 复制现有环境，避免替换后丢掉 PATH 等目标程序可能需要的变量。
	env := append([]string{}, os.Environ()...)
	env = append(env, "APP_MODE=handoff")

	// 成功时当前映像被替换，下面的代码不会继续执行。
	if err := syscall.Exec(argv0, argv, env); err != nil {
		// 只有 execve 失败才会走到这里，保留原始错误便于诊断。
		fmt.Fprintf(os.Stderr, "替换进程失败：%v\\n", err)
		os.Exit(1)
	}
}

这里的 argv[0] 写成 sh，而不是再次写完整路径，是为了符合目标程序通常读取命令名的约定；真正被执行的文件仍由 argv0 指定。若目标程序依赖一个干净环境，可以显式构造 envv，但要确认它不会因此失去必要的路径或区域设置。

成功不返回，失败才回到 Go 代码

调用 syscall.Exec 前，建议按固定顺序检查文件路径、参数内容和环境来源。不要把“成功后打印一行日志”写在调用之后，因为成功替换后已经没有原来的 Go 函数栈可以继续执行。

如果目标文件不存在、没有执行权限或参数无法转换，系统调用会返回错误；这时原进程还在，调用方可以记录错误并退出。对需要恢复的程序，不要在不改变输入的情况下无限重试，否则只是把同一个失败条件循环放大。

兼容边界与我的采用建议

官方文档提醒，syscall 是面向底层操作系统原语的包，细节会随系统变化；能使用更高层的 os、os/exec 时，通常优先选择它们。对需要真正替换当前映像的 Unix 工具、启动交接器或进程引导程序，syscall.Exec 才有明确价值。

我的取舍是：如果父进程还要收集输出、等待退出或处理超时，就用 os/exec；如果目标是让当前进程直接变成另一个程序，并且能接受成功后不再返回，才使用 syscall.Exec。跨平台项目把这段代码隔离到 Unix 构建文件，其他系统提供替代实现，维护成本会更可控。

结论与常见问题

syscall.Exec 的核心是替换，不是派生。准备好目标路径、以程序名开头的 argv 和明确的 envv 后调用；把所有成功后的逻辑移到调用前，把失败处理留在返回 error 的分支里。若只是运行外部命令而不想牺牲当前 Go 进程，优先考虑 os/exec。

syscall.Exec 成功后为什么没有返回值？

它替换了当前进程的程序映像，原来的 Go 代码不再是正在执行的映像，所以只有失败路径会返回 error。

argv0 和 argv[0] 为什么要分别传？

argv0 用于指定要执行的文件，argv[0] 是目标程序接收到的参数数组首项。两者经常内容相近，但职责不同，不能依赖函数自动替换。

什么时候不应该用 syscall.Exec？

需要保留父进程、等待子进程、读取标准输出、设置超时或兼容多个操作系统时，通常应先看 os/exec 等更高层接口。