• 避免裸参数

    避免裸参数

    函数调用中的裸参数可能会降低代码可读性。所以当参数名称的含义不明显时，请为参数添加 C 样式的注释（/ … /）。

    BadGood
    1. // func printInfo(name string, isLocal, done bool)
    3. printInfo("foo", true, true)
    		 
    1. // func printInfo(name string, isLocal, done bool)
    3. printInfo("foo", true / isLocal /, true / done /)

    上面更好的作法是将 bool 类型替换为自定义类型，从而使代码更易读且类型安全。将来需要拓展时，该参数也可以不止两个状态（true/false）。

    1. type Region int
    3. const (
    4.   UnknownRegion Region = iota
    5.   Local
    6. )
    8. type Status int
    10. const (
    11.   StatusReady = iota + 1
    12.   StatusDone
    13.   // 也许将来我们会有 StatusInProgress。
    14. )
    16. func printInfo(name string, region Region, status Status)