下面这些是Go 语言本身的规则编译器/运行时强制或官方强烈约定。常见规范1. 包与可见性一个目录 一个包包名通常等于目录名。首字母大写导出小写仅本包。package mainfunc main()才是可执行入口。只能import别的包不能 import 单个文件同包文件互相可见、不用 import。2. 编译与依赖模块以go.mod的module名为 import 前缀本仓库是audit-review。循环 import 禁止A import B、B 再 import A 会编译失败。未使用的 import、未使用的局部变量是编译错误_可丢掉不想用的值。没有隐式类型转换int32和int64必须显式转。3. 零值与指针变量声明后就是零值0、、nil、false没有「未初始化」的垃圾值。nil指针解引用会 panic。new(T)/T{}得到*T方法接收者常用指针避免拷贝、允许修改。4. 错误处理没有异常体系当主路径约定返回(result, error)。error nil才算成功忽略 error 是合法语法但是坏习惯。panic只用于真正不可恢复配置都扫不进来recover一般只在框架中间件里。5. 控制流if err ! nil { return ..., err }是常态没有try/catch。defer函数返回前执行关文件、Cleanup()后写的 defer 先执行。for是唯一循环range遍历切片/map/channel。switch不用写break默认不会落到下一分支和 C 不同。6. 接口接口是隐式实现有方法就算实现不用写implements。小接口更常见error就一个Error() string。接口变量底层是「类型 值」值为nil但带着类型时 nil可能是false踩坑点。7. 切片、map、append切片是对底层数组的视图len/cap。append可能换新数组必须接住返回值。map 零值是nil读可以、写之前要make。map 遍历顺序每次不一定相同。8. 并发go f()开 goroutine和线程不是 1:1。channel 用来通信向已关闭的 channel 发送会 panic。没有内置的「共享内存加锁就安全」保证数据竞争要自己避免sync.Mutex或不要共享。init.go里那种go uc.createKnowledgeWithRetry就是语言级的 goroutine。9. 官方习惯不是语法强制但大家当规则用对外方法第一个参数常常是ctx context.Context本仓库硬性要求。短接收者名func (s *AuditTaskService)不用this。错误先处理成功逻辑往下写少套一层else。包名小写、不用下划线bootstrap、audit_task是文件名包名仍是service/biz。格式化用gofmt/goimports空格缩进、大括号风格都是固定的。语法1. 带「初始化语句」的和if a; b同一类语法都是可选的一句简单语句再;再表达式。ififerr:localCfg.Load();err!nil{...}ifv:foo();v0{...}switchswitchn:len(items);n{case0:case1:default:}也可以switch x : v.(type)类型分支见下。for三段式比 if 多一段「每次循环后」fori:0;i10;i{...}这几个里只有for允许三个分号隔开的部分if/switch最多一个分号。2. 其它循环 / 分支for range没有for-infor_,e:ranged.Enterprises{...}fork,v:rangesomeMap{...}select多路等 channel样子像 switchselect{casev:-ch:casech2-x:case-ctx.Done():returnctx.Err()}switch默认不贯穿不用写break要贯穿才写fallthrough。条件也可以省略当switch true。3. 声明与赋值短声明:至少有一个新变量。只给已有变量赋值。多返回值id, _ os.Hostname()。_故意丢掉。命名返回值func f() (logDir, cacheDir string, err error)函数里可以直接给这些名字赋值再return。4. 函数相关接收者方法func (s *AuditTaskService) UpdateAuditTask(...)defer函数返回前执行后写的先跑。go f()新 goroutine。func init()包加载时自动跑。可变参数func f(a ...int)。没有三元运算? :用if/else。5. 类型与「comma-ok」接口断言、map、channel 接收都是「值, 是否成功」x,ok:i.(int)// 类型断言v,ok:seen[item.ID]// mapv,ok:-ch// channel类型 switchswitchx:err.(type){case*os.PathError:default:}6. 指针 / 复合字面量Infrastructure{Logger:l}// 取地址 结构体字面量[]int{1,2,3}map[int64]struct{}{}// 当 set 用make([]int64,0,n)切片s[low:high]append必须接返回值。7. 包与构建不算表达式但很「特殊」首字母大小写 是否导出import atv1 path别名import _ 包只为跑init本仓库 yaml、automaxprocs//go:build wireinject构建标签对照记想做的事Goif 里先算再判断if stmt; cond循环for/for range没有while多返回 丢弃a, _ : f()异步go f()不是 Promise延迟清理defer空值零值 nil没有undefined日常读main.go够用的就是if/switch的语句; 条件、for三段、:、多返回值、defer、go。其余碰到再查即可。想系统过一遍官方 A Tour of Go 比一次性背完整语言规范有效。