sublime text 的 go 构建系统需显式配置 go 绝对路径、正确 selector（如 "source.go"）、环境变量 gopath/goroot，并将 .sublime-build 文件置于 packages/user/ 目录下。

Go构建系统必须显式指定go命令路径

Sublime Text 不继承 shell 的 PATH，即使终端里 go version 能跑通，go build 在 Ctrl+B 里也可能报 “command not found”。这不是 Go 没装好，而是构建系统根本找不到 go 可执行文件。

• 用 which go（macOS/Linux）或 where go（Windows）查出真实路径，比如 /usr/local/go/bin/go 或 C:\Go\bin\go.exe
• 在 .sublime-build 文件里别写 "shell_cmd": "go build"，改用绝对路径："shell_cmd": "/usr/local/go/bin/go build"
• 如果要用不同 Go 版本，就得为每个版本建独立的构建文件，比如 Go-1.21.sublime-build 和 Go-1.22.sublime-build，各自写死对应版本的 go 路径

selector 写错会导致 Go 文件根本触发不了构建

Sublime 不靠文件后缀判断语言，而是靠语法高亮对应的 scope。你右键 → Syntax: Show Syntax 看到的才是真实 selector —— 大概率是 source.go，不是 text.go 或 go。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 必须写 "selector": "source.go"，多一个空格、少一个点都会失效
• 别删掉 selector 字段试图“通用”，那样会让构建项出现在所有文件菜单里，反而容易误选
• 如果用的是自定义语法包（比如 GoSublime），它的 selector 可能略有不同，得实际看 Show Syntax 输出

环境变量不透传，GOPATH/GOROOT 得手动塞进 env

Go 构建失败报 cannot find package，90% 是因为 Sublime 的构建进程没拿到 GOPATH。它和你的终端不是同一个环境，$GOPATH 在构建里就是空的。

• 在 .sublime-build 里加 "env" 字段，显式写死路径："env": {"GOPATH": "/home/you/go", "GOROOT": "/usr/local/go"}
• GOROOT 必须指向 Go 安装根目录（含 src、bin 子目录），不是 bin 目录本身
• 多个 Go 版本共存时，每个 .sublime-build 文件里的 GOROOT 和 GOPATH 都得对应匹配，混用会编译失败

文件必须放在 Packages/User/ 下才生效

Sublime 只认 Packages/User/ 这个固定路径下的 .sublime-build 文件。放错地方、扩展名带隐藏后缀、或者用中文命名，都会导致 Tools → Build System 菜单里压根看不到选项。

• Windows 路径：%APPDATA%\Sublime Text\Packages\User\
• macOS 路径：~/Library/Application Support/Sublime Text/Packages/User/
• 保存时确认后缀是 .sublime-build，不是 .json 或 .sublime-build.txt
• 文件名建议用英文+数字，比如 Go-1.21.9.sublime-build，避免空格和特殊符号

真正麻烦的不是写配置，而是每次切换 Go 版本时，你得同步更新 shell_cmd 路径、GOROOT、GOPATH，三者缺一不可。漏掉任何一个，Ctrl+B 就会静默失败或报错位置极其误导。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！