Golang 需要避免踩的 50 個坑（一）

// 錯誤示例
func main()
{
println("hello world")
}

// 等效於
func main();// 無函式體
{
println("hello world")
}

// 正確示例
func main() {
println("hello world")
}

// { 並不遵守分號注入規則，不會在其後邊自動加分，此時可換行
func main() {
{
println("hello world")
}
}

// 錯誤示例
var gvar int // 全域性變數，宣告不使用也可以

func main() {
var one int // error: one declared and not used
two := 2// error: two declared and not used
var three int// error: three declared and not used
three = 3
}


// 正確示例
// 可以直接註釋或移除未使用的變數
func main() {
var one int
_ = one

two := 2
println(two)

var three int
one = three

var four int
four = four
}

// 錯誤示例
import (
"fmt"// imported and not used: "fmt"
"log"// imported and not used: "log"
"time"// imported and not used: "time"
)

func main() {
}


// 正確示例
// 可以使用 goimports 工具來註釋或移除未使用到的包
import (
_ "fmt"
"log"
"time"
)

func main() {
_ = log.Println
_ = time.Now
}

// 錯誤示例
myvar := 1// syntax error: non-declaration statement outside function body
func main() {
}


// 正確示例
varmyvar = 1
func main() {
}

// 錯誤示例
func main() {
one := 0
one := 1 // error: no new variables on left side of :=
}


// 正確示例
func main() {
one := 0
one, two := 1, 2// two 是新變數，允許 one 的重複宣告。比如 error 處理經常用同名變數 err
one, two = two, one// 交換兩個變數值的簡寫
}

// 錯誤示例
type info struct {
result int
}

func work() (int, error) {
return 3, nil
}

func main() {
var data info
data.result, err := work()// error: non-name data.result on left side of :=
fmt.Printf("info: %+v\n", data)
}


// 正確示例
func main() {
var data info
var err error// err 需要預宣告

data.result, err = work()
if err != nil {
fmt.Println(err)
return
}

fmt.Printf("info: %+v\n", data)
}

func main() {
x := 1
println(x)// 1
{
println(x)// 1
x := 2
println(x)// 2// 新的 x 變數的作用域只在程式碼塊內部
}
println(x)// 1
}

> go tool vet -shadow main.go
main.go:9: declaration of "x" shadows declaration at main.go:5

> $GOPATH/bin/go-nyet main.go
main.go:10:3:Shadowing variable `x`

// 錯誤示例
func main() {
var x = nil// error: use of untyped nil
_ = x
}


// 正確示例
func main() {
var x interface{} = nil
_ = x
}

// map 錯誤示例
func main() {
var m map[string]int
m["one"] = 1// error: panic: assignment to entry in nil map
// m := make(map[string]int)// map 的正確宣告，分配了實際的記憶體
}


// slice 正確示例
func main() {
var s []int
s = append(s, 1)
}

// 錯誤示例
func main() {
m := make(map[string]int, 99)
println(cap(m)) // error: invalid argument m1 (type map[string]int) for cap
}

// 錯誤示例
func main() {
var s string = nil// cannot use nil as type string in assignment
if s == nil {// invalid operation: s == nil (mismatched types string and nil)
s = "default"
}
}


// 正確示例
func main() {
var s string// 字串型別的零值是空串 ""
if s == "" {
s = "default"
}
}

// 陣列使用值拷貝傳參
func main() {
x := [3]int{1,2,3}

func(arr [3]int) {
arr[0] = 7
fmt.Println(arr)// [7 2 3]
}(x)
fmt.Println(x)// [1 2 3]// 並不是你以為的 [7 2 3]
}

// 傳址會修改原資料
func main() {
x := [3]int{1,2,3}

func(arr *[3]int) {
(*arr)[0] = 7
fmt.Println(arr)// &[7 2 3]
}(&x)
fmt.Println(x)// [7 2 3]
}

// 會修改 slice 的底層 array，從而修改 slice
func main() {
x := []int{1, 2, 3}
func(arr []int) {
arr[0] = 7
fmt.Println(x)// [7 2 3]
}(x)
fmt.Println(x)// [7 2 3]
}

// 錯誤示例
func main() {
x := []string{"a", "b", "c"}
for v := range x {
fmt.Println(v)// 1 2 3
}
}


// 正確示例
func main() {
x := []string{"a", "b", "c"}
for _, v := range x {// 使用 _ 丟棄索引
fmt.Println(v)
}
}

// 使用各自獨立的 6 個 slice 來建立 [2][3] 的動態多維陣列
func main() {
x := 2
y := 4

table := make([][]int, x)
for i:= range table {
table[i] = make([]int, y)
}
}

func main() {
h, w := 2, 4
raw := make([]int, h*w)

for i := range raw {
raw[i] = i
}

// 初始化原始 slice
fmt.Println(raw, &raw[4])// [0 1 2 3 4 5 6 7] 0xc420012120 

table := make([][]int, h)
for i := range table {

// 等間距切割原始 slice，建立動態多維陣列 table
// 0: raw[0*4: 0*4 + 4]
// 1: raw[1*4: 1*4 + 4]
table[i] = raw[i*w : i*w + w]
}

fmt.Println(table, &table[1][0])// [[0 1 2 3] [4 5 6 7]] 0xc420012120
}

> php -r '$v = ["x"=>1, "y"=>2]; @var_dump($v["z"]);'
NULL

// 錯誤的 key 檢測方式
func main() {
x := map[string]string{"one": "2", "two": "", "three": "3"}
if v := x["two"]; v == "" {
fmt.Println("key two is no entry")// 鍵 two 存不存在都會返回的空字串
}
}

// 正確示例
func main() {
x := map[string]string{"one": "2", "two": "", "three": "3"}
if _, ok := x["two"]; !ok {
fmt.Println("key two is no entry")
}
}

// 修改字串的錯誤示例
func main() {
x := "text"
x[0] = "T"// error: cannot assign to x[0]
fmt.Println(x)
}


// 修改示例
func main() {
x := "text"
xBytes := []byte(x)
xBytes[0] = 'T'// 注意此時的 T 是 rune 型別
x = string(xBytes)
fmt.Println(x)// Text
}

func main() {
x := "text"
xRunes := []rune(x)
xRunes[0] = '我'
x = string(xRunes)
fmt.Println(x)// 我ext
}