答案是GoLand外部工具需用$FilePath$等宏动态传入路径，并确保Program填绝对路径、Arguments用双引号包裹含空格路径，同时补全PATH环境变量以防command not found。
怎么配置一个能自动传入当前文件路径的外部工具
GoLand 的 External Tools 本质是把命令行程序包装成 IDE 内可触发的动作，关键在于让 Arguments 和 Working directory 能动态响应上下文。最常用也最容易出错的是路径宏用法。
-
$FilePath$是绝对路径，含文件名；$FileDir$是所在目录（不含尾部斜杠）；$ProjectFileDir$是项目根目录 - 如果工具参数要求相对路径（比如某些 lint 工具），别直接填
$FilePath$，先用$FileDir$+ 手动拼接，或改用$RelativeFilepath$ - 路径含空格时，必须用双引号包裹宏，例如：
"-f" "$FilePath$"，否则 GoLand 会把空格当成参数分隔符 - Windows 下路径反斜杠会被转义，建议统一用正斜杠或在宏外加
file://前缀（部分工具如 curl 需要）
为什么 OptiPNG 或 gofumpt 这类工具总报“command not found”
错误不是工具本身问题，而是 GoLand 启动时没继承 shell 的 PATH 环境变量。IDE 默认用最小环境运行外部命令，which optipng 或 go install -bin 安装的二进制很可能不在其搜索路径里。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 首选方案：在
Program字段填绝对路径，比如/usr/local/bin/optipng或$HOME/go/bin/gofumpt - 次选方案：在
Environment variables里手动补全 PATH，例如PATH=/usr/local/bin:/opt/homebrew/bin:$PATH - Mac 用户特别注意：如果用 zsh 或 fish，而 GoLand 是从 Dock 启动的，它不会加载
~/.zshrc，必须显式指定路径或改用 launchd 启动方式
如何让外部工具在保存时自动触发
GoLand 没有原生“on save run tool”开关，但可通过 Run Configuration + Before launch 组合实现，比 File Watchers 更可靠且可控。
- 新建一个
Go Build类型的运行配置，名称设为Run on Save - 在
Before launch区域点击+→Run External Tool→ 选你已配好的工具 - 勾选
Activate tool window，这样出错时能立刻看到输出 - 把这个配置绑定到快捷键（如
Ctrl+S），或配合File | Settings | Tools | File Watchers中的 “Auto-save edited files” 选项使用 - 注意：不要在多个配置里重复添加同一工具，否则保存一次会触发多次执行
调试外部工具输出乱码或中文显示为问号
根本原因是 GoLand 控制台默认编码与工具输出编码不一致，尤其在 Windows 上 cmd 输出 GBK、Linux/macOS 终端默认 UTF-8，而 IDE 统一按 UTF-8 解析。
- Windows 用户：在工具
Arguments里加chcp 65001 >nul &开头（需用cmd /c包裹整个命令） - macOS/Linux 用户：检查工具是否强制输出 ANSI 转义序列，可在
Program前加script -qec或改用env LANG=en_US.UTF-8 - 通用办法：进入
Help | Edit Custom Properties，添加idea.file.encoding=UTF-8并重启 IDE - 临时验证：在终端里手动运行相同命令，对比输出是否一致 —— 如果终端也乱码，说明是工具自身问题，不是 GoLand 设置
$Macro$ 都要确认展开后是否真实存在，每个 Program 都要用绝对路径兜底。 
