Go SDK需手动指定GOROOT根目录而非bin路径；Go Modules初始化失败多因GOPROXY不可用或存在go.work文件；Run Configuration中Working directory应设为$FileDir$或使用go run ./cmd/myapp；_test.go文件需符合命名及TestXxx(t *testing.T)签名规范。
Go SDK 路径必须手动指定，不能依赖系统 PATH
Goland 不会自动从 $PATH 读取 go 命令位置，即使终端里 which go 能返回正确路径，IDE 仍可能报 “No Go SDK found”。必须在设置中显式指向 GOROOT 下的根目录（例如 /usr/local/go 或 C:\Go），而不是 bin 子目录。
- macOS / Linux：打开 Settings → Go → GOROOT，填入
/usr/local/go（不是/usr/local/go/bin/go） - Windows：填入
C:\Go，确认该路径下存在src、pkg、bin三个子目录 - 若使用
go install安装的多版本（如go1.21.0），需解压后手动指定完整路径，Goland 不识别goenv或g等版本管理器的软链
Go Modules 初始化失败常见于 GOPROXY 或 go.work 配置冲突
新建项目后右下角提示 “Initialize Go Modules” 却无响应，大概率是代理或工作区配置干扰。Goland 在首次加载模块时会调用 go mod download，但若 GOPROXY 不可用或当前目录已存在 go.work 文件，会导致静默卡住。
- 检查
GOPROXY：在 Settings → Go → Go Modules 中确认代理地址有效，国内推荐填https://goproxy.cn,direct - 删掉残留的
go.work：该文件会强制启用多模块工作区模式，若项目本是单模块，反而阻断初始化 - 手动触发：在 Terminal 中执行
go mod init example.com/myapp，再刷新项目，Goland 通常能自动识别
Run Configuration 中的 Working directory 影响 go run 行为
点击绿色三角运行 main.go 时提示 “no Go files in current directory”，其实是当前工作目录不对。Goland 默认把 Working directory 设为项目根目录，但如果项目结构是 cmd/myapp/main.go，而你直接打开了 main.go 文件，Run Configuration 仍会以项目根为起点执行 go run，导致找不到包。
Handsfree Windows Control
下载
通过 handsfree-windows CLI控制 Windows 本机应用 (UIA) 和浏览器 (Playwright) 的引导技能，用于自动化或测试桌面应用。
- 编辑 Run Configuration → Working directory 改为
$FileDir$（即当前文件所在目录） - 或统一用
go run ./cmd/myapp形式，在 Program arguments 中填写子命令路径 - 避免混用
go run main.go和go run .：前者不解析import路径，后者才真正按 module 规则加载
Go Test 模板无法识别 _test.go 文件？检查文件名和函数签名
写完 xxx_test.go 后右侧没出现“Run Test”图标，不是插件问题，而是命名或函数不符合 Go 测试规范。
立即学习“go语言免费学习笔记（深入）”；
- 文件名必须以
_test.go结尾，且与被测代码在同一包（例如utils.go和utils_test.go都在package utils） - 测试函数必须是
func TestXxx(t *testing.T)格式，首字母大写的Xxx，且参数类型严格为*testing.T（不是*testing.B或自定义 struct） - 如果用了
//go:build test等构建约束，确保当前 build tags 设置匹配（Settings → Go → Build Tags）
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
Goland 的 Go 支持深度依赖 go list 和 go mod graph 的输出结果，任何影响这些命令执行的因素（比如权限、代理、磁盘只读、Go SDK 版本太旧）都会导致功能降级，现象看似是 IDE Bug，实际根源常在 CLI 层。 
