Go 中 exec.Command("screenshot-tool") 失败主因是不自动查 PATH、不继承 DISPLAY 等环境变量、无图形会话权限；应使用绝对路径、显式设置环境变量、校验文件输出并设超时捕获错误。
为什么直接 exec.Command("screenshot-tool") 在 Go 里大概率失败
因为 Go 的 exec.Command 不会自动查找 PATH 中的可执行文件，也不会继承 shell 的环境变量（比如 DISPLAY），更不会帮你安装依赖工具。你本地终端能跑的命令，Go 里常报 exec: "xxx": executable file not found in $PATH 或 X11 connection rejected because of wrong authentication。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用绝对路径调用二进制，比如
/usr/bin/maim而非maim；可通过which maim或command -v maim确认 - 显式设置环境变量：
cmd.Env = append(os.Environ(), "DISPLAY=:0")（Linux X11 场景） - 确保目标用户（如 systemd service 运行的用户）有权限访问图形会话——普通用户启动的 Go 程序通常没权限截当前桌面
- macOS 需额外授权：在“系统设置 → 隐私与安全性 → 屏幕录制”中允许你的 Go 可执行文件
macOS 上用 screencapture 命令截图的坑点
screencapture 是 macOS 自带工具，但默认行为和参数容易踩错：不加 -x 会播放快门音效、不加 -t 会生成 .png 但后缀名却是 .jpg（实际是 PNG 内容）、-o（只截窗口）在无焦点窗口时静默失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 最稳妥组合：
screencapture -x -t png -o /tmp/screenshot.png（静音 + 显式格式 + 当前窗口） - 全屏截图用
-m，区域截图需配合-i（交互模式），但后者会阻塞进程——不适合自动化 - Go 中调用时务必检查
cmd.Run()返回的 error，screencapture失败时 exit code 不为 0，但不会输出错误到 stdout，要读stderr - 注意路径权限：
/tmp/可写，但./screenshot.png在某些上下文（如 launchd）下可能因工作目录不可写而失败
Linux 下 maim vs. gnome-screenshot 的取舍
maim 轻量、支持区域选择、命令行友好；gnome-screenshot 重、依赖 GNOME 环境、部分参数（如 --delay）在 Wayland 下失效。两者都不处理多显示器缩放问题——HiDPI 屏幕截图后尺寸会翻倍或模糊。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先选
maim：装法简单（sudo apt install maim/sudo pacman -S maim），参数直观：maim -u -o /tmp/cap.png（-u去除光标，-o当前窗口） - Wayland 用户必须用
grim替代maim（maim仅支持 X11），且需确认WLR_FRAMES环境已就绪 - 截图后记得校验文件是否存在且非空：
if _, err := os.Stat("/tmp/cap.png"); os.IsNotExist(err) || stat.Size() == 0 { ... } - 避免用
maim -s（交互选区）在后台运行——它会等待用户鼠标操作，导致 Go 程序卡死
Go 调用命令时如何可靠捕获错误和超时
exec.Command 默认不设超时，遇到 GUI 工具挂起（比如 gnome-screenshot --interactive 被误用）就会永久阻塞；错误信息也常藏在 stderr 里，不主动读就丢掉。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须设超时：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)，然后用exec.CommandContext(ctx, ...) - 显式绑定 stderr：
cmd.Stderr = &buf（var buf bytes.Buffer），出错后buf.String()才能看到真实原因 - 别只看
err != nil，还要检查cmd.ProcessState.ExitCode()—— 某些工具（如screencapture）失败时 err 为 nil，但 exit code 非 0 - 截图命令输出的是二进制文件，不是文本，所以不要用
cmd.Output()（它会尝试 UTF-8 解码并失败），改用cmd.Run()+ 文件路径验证
真正麻烦的从来不是调哪个命令，而是图形环境权限、显示协议差异、以及没人告诉你截图工具在不同桌面会静默降级或彻底失效。
