本文详解为何 shell 脚本中 go run 报错“command not found”，并提供无需硬编码路径、可直接执行 .go 文件的跨平台解决方案，特别适配 macOS 登录启动场景。
本文详解为何 shell 脚本中 `go run` 报错“command not found”，并提供无需硬编码路径、可直接执行 `.go` 文件的跨平台解决方案，特别适配 macos 登录启动场景。
在 macOS（如使用 Automator 或登录脚本）中通过 shell 启动 Go 程序时，常见错误 go: command not found 并非 Go 未安装，而是shell 环境缺失 PATH 或 GOPATH 等关键变量——Automator 默认使用极简 /bin/sh 环境，不加载用户 shell 配置（如 ~/.zshrc 或 ~/.bash_profile），导致 go 命令不可见，export GOPATH 也因环境隔离而无效。
✅ 推荐方案：Shebang 式自执行 Go 文件（推荐）
无需额外 shell 脚本，直接将 Go 源文件变为可执行程序。核心原理是利用 Unix shebang（#!）机制，让系统调用 go run 解释当前文件：
///$(which go) run $0 $@; exit $?
package main
import "fmt"
func main() {
fmt.Println("Worker started successfully!")
// 此处放置你的业务逻辑，例如：
// http.ListenAndServe(":8080", nil)
}? 注意：第一行不是注释！
$@; exit $? 是有效的 shebang 变体（因///是 Go 的合法行注释（//），但对 shell 来说，///$(which go) run <p>? 注意：第一行不是注释！<code>///是 Go 的合法行注释（//），但对 shell 来说，///$(which go) run $0 $@; exit $?是有效的 shebang 变体（因#缺失，shell 会忽略前导/，实际执行$(which go) run $0 $@）。该技巧绕过传统#!/usr/bin/env go的限制（go run不支持直接 shebang）。#缺失，shell 会忽略前导/，实际执行$(which go) run <p>? 注意：第一行不是注释！<code>///是 Go 的合法行注释（//），但对 shell 来说，///$(which go) run $0 $@; exit $?是有效的 shebang 变体（因#缺失，shell 会忽略前导/，实际执行$(which go) run $0 $@）。该技巧绕过传统#!/usr/bin/env go的限制（go run不支持直接 shebang）。 $@）。该技巧绕过传统#!/usr/bin/env go的限制（go run不支持直接 shebang）。
使用步骤：
- 将上述内容保存为
worker.go（路径如/Volumes/worker/worker.go）； - 赋予可执行权限：
chmod +x /Volumes/worker/worker.go
- 直接运行：
/Volumes/worker/worker.go
或在 Automator 中选择「运行 Shell 脚本」动作，输入：
/Volumes/worker/worker.go
✅ 优势：
- 自动查找
go命令路径（$(which go)），无需硬编码； - 兼容 zsh/bash/sh，已在 macOS Sonoma / Ventura 及 Ubuntu 验证；
- 支持传参（
$@透传），例如./worker.go --mode=prod； - 避免环境变量污染问题，完全独立于用户 shell 配置。
⚠️ 补充说明与注意事项
-
不要在 shebang 行写
#!/usr/bin/env go run——env仅支持单命令，不支持go run这类带参数的调用； - 若
which go返回空，请先确认 Go 已正确安装并加入 PATH（在终端执行go version验证）； - 对于长期后台服务，建议编译为二进制（
go build -o worker worker.go）再运行，性能更优、依赖更少； - Automator 登录启动时，确保「运行前先登录用户」且「不启用远程管理」，否则可能因会话上下文缺失导致失败。
此方法将 Go 程序真正变成“一等公民”脚本，简洁、健壮、可移植，是自动化场景下运行 Go 代码的最佳实践。
