Go exec.Command 为什么找不到当前目录下的程序

用 Go 调用项目目录里的 worker、tool 这类可执行文件时，如果写成 exec.Command("worker")，程序可能提示找不到文件，或者返回 cannot run executable found relative to current directory。这通常不是文件真的不存在，而是裸名称触发了 PATH 查找；Go 1.19 起，os/exec 会拒绝把当前目录中的结果当成安全的隐式命令。

需要运行当前目录的程序，就把路径写出来：Unix 使用 ./worker，Windows 使用 .\worker.exe。如果必须保留裸名称，再用 errors.Is(err, exec.ErrDot) 精确判断，不要直接关闭所有错误。

一、exec.Command 查找程序时为什么忽略当前目录

exec.Command(name, args...) 的第一个参数如果不含路径分隔符，就会尝试通过 LookPath 找到完整路径；它不会像 shell 那样自动把当前目录当作可靠的命令来源。这样做是为了避免工作目录中的同名文件被意外执行。

从 Go 1.19 起，即使操作系统的 PATH 中包含 .，或者某个相对 PATH 项最终指向当前目录，LookPath 也会返回带有 exec.ErrDot 的错误。也就是说，下面的写法表达的是“按环境查找名为 worker 的程序”，并没有表达“运行当前目录的 worker”。

cmd := exec.Command("worker", "--once")
// Run 会使用 Command 创建时的查找结果；裸名称可能触发 ErrDot。
if err := cmd.Run(); err != nil {
	log.Fatal(err)
}

这里要区分两种错误：exec.ErrNotFound 表示 PATH 没有找到目标；exec.ErrDot 表示虽然解析结果落到了当前目录，但标准库要求你明确确认。前者要检查安装和 PATH，后者优先改调用路径。

二、运行当前目录程序要显式写相对路径

确定目标就是包内或工作目录下的文件时，直接写相对路径最简单。Unix-like 系统使用 ./worker；Windows 的可执行文件通常带 .exe，可写为 .\worker.exe。路径中有分隔符后，Command 不再按裸名称走 PATH 查找。

package main

import (
	"fmt"
	"os/exec"
)

func main() {
	// 路径带 ./，明确指定当前目录的 worker，而不是依赖 PATH。
	cmd := exec.Command("./worker", "--once")
	out, err := cmd.CombinedOutput()
	if err != nil {
		// 保留子进程输出，便于区分权限、参数和退出码问题。
		fmt.Printf("执行失败：%v\n%s", err, out)
		return
	}
	fmt.Print(string(out))
}

如果同一份代码要支持 Windows，可以让构建配置提供完整的本地路径，而不是简单把 worker 交给 PATH。路径应当来自可信配置或固定目录；不要把用户输入未经约束地拼接成要执行的文件名。

三、exec.ErrDot 怎么判断和处理

若旧代码确实依赖 PATH 中的相对目录，可以针对 ErrDot 做一次明确判断。exec.Command 可能在创建命令时把查找错误放到 cmd.Err，所以要在 Run 前处理它；判断时必须使用 errors.Is，不能用 err == exec.ErrDot，因为错误可能被包装。

package main

import (
	"errors"
	"log"
	"os/exec"
)

func runLegacyPath() error {
	cmd := exec.Command("worker")
	// 只对 ErrDot 做显式决策，不吞掉真正的找不到或启动错误。
	if errors.Is(cmd.Err, exec.ErrDot) {
		// 仅在已确认 PATH 和工作目录均可信时采用旧行为。
		cmd.Err = nil
	}
	if err := cmd.Run(); err != nil {
		return err
	}
	return nil
}

func main() {
	if err := runLegacyPath(); err != nil {
		log.Fatal(err)
	}
}

更推荐把上面的兼容分支替换成显式相对路径。若暂时无法修改调用点，GODEBUG=execerrdot=0 可以停生成这类错误，但它是全局运行时开关，未来版本也可能移除，生产环境不宜把它当长期修复。

四、把工作目录、PATH 和程序路径分开排查

很多排查会误改 cmd.Dir。它控制子进程启动后的工作目录；当为空时，子进程继承调用进程的当前目录。它不等价于“让 exec.Command("worker") 去当前目录找 worker”，因为裸名称的查找发生在命令执行路径确定阶段。

可以按下面的顺序核对，避免把多个问题混成一个：

• 程序路径：本地文件就使用显式相对路径或绝对路径；确认 Unix 执行权限，Windows 确认扩展名。
• PATH：系统命令才依赖 PATH；检查服务进程的 PATH 是否和交互式终端不同。
• 工作目录：需要让子程序读取相对配置文件时再设置 cmd.Dir，并注意它改变的是子进程的文件解析位置。
• 错误层次：先处理 cmd.Err 的查找错误，再读取 Run 或 CombinedOutput 的启动、退出和输出错误。

这样处理后，“找不到当前目录程序”通常可以归结为一个清楚的选择：目标属于系统 PATH，使用裸名称；目标属于当前项目，使用带路径分隔符的显式路径；必须兼容旧行为，再把 ErrDot 作为唯一例外审慎放行。

相关问题

为什么加了 cmd.Dir 还是找不到程序？

Dir 只设置子进程工作目录，不会把裸程序名自动变成当前目录路径。请改用 ./worker 或 .\worker.exe。

exec.ErrDot 和文件不存在是一回事吗？

不是。ErrDot 说明解析结果涉及当前目录并被安全策略拦截；文件不存在或 PATH 无结果才更接近 ErrNotFound。

可以一直设置 GODEBUG=execerrdot=0 吗？

不建议。它会放宽所有相关调用点，优先修正为显式路径；只有暂时无法改代码且目录来源完全受控时，才把它作为过渡措施。

参考：Go 官方 os/exec 文档：Executables in the current directory。