Go

data, err := os.ReadFile(path)
if err != nil {
    return nil, fmt.Errorf("read config %q: %w", path, err)
}

%w 保留错误链，调用者可以 errors.Is/As 判断根因。

req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
if err != nil { return err }
resp, err := client.Do(req)

context 从入口传递，不存入长期结构体；外部 I/O 应有 deadline。

go mod init example.com/memory-tools
go mod tidy

模块路径是导入身份；发布公共模块后不应随意改变。

func main() {
    if err := run(context.Background(), os.Args[1:]); err != nil {
        log.Printf("error: %v", err)
        os.Exit(1)
    }
}

把可测试逻辑放入返回 error 的 run，main 只处理进程退出。

gofmt -w .
go vet ./...
go test ./...
go build ./cmd/memory-tools

CI 中格式检查可比较 gofmt 输出而不是修改文件。

$env:GOOS="linux"; $env:GOARCH="amd64"; go build ./cmd/memory-tools

这是 PowerShell 示例；涉及 cgo 时还需要目标平台 C 工具链。

go list -m all
go list -m -u all
go get example.com/module@v1.2.3
go mod tidy

升级后检查 release notes 并运行测试、race 与集成验证。

go mod why -m example.com/module

显示主模块为何需要该模块，便于清理与审计。

for _, tc := range []struct { in string; want int }{{"2", 2}, {" 5 ", 5}} {
    t.Run(tc.in, func(t *testing.T) {
        if got := parse(tc.in); got != tc.want { t.Fatalf("got %d", got) }
    })
}

循环变量语义依 Go 版本而不同；并行子测试仍应明确捕获所需值。

go test ./... -cover
go test -race ./...

race 会显著变慢，只检测实际执行路径；为并发分支补充分层测试。

检查无接收者发送、无发送者接收、WaitGroup 计数、未关闭通道和持锁阻塞；采集 goroutine dump。

关闭通道通常由发送方负责；不要为“通知完成”随意关闭共享通道。

接口包含动态类型和值；装入 typed nil 指针后接口本身不等于 nil。返回 error 时直接 return nil。

调试时同时打印接口动态类型和值。

server := &http.Server{
    Addr: ":8080", Handler: handler,
    ReadHeaderTimeout: 5 * time.Second,
    ReadTimeout: 15 * time.Second, WriteTimeout: 15 * time.Second,
}

还应限制请求体、并发、上传和下游调用时间。

SQL 参数化；exec.Command 分离参数；路径限制在可信根目录；随机数按安全用途选择 crypto/rand；秘密不写日志。

接口小和内存安全不自动解决授权、注入或拒绝服务。