Biến trong Golang: var, :=, giá trị zero và shadowing

Go có hai cách khai báo biến (variable): var, dùng được ở mọi nơi, và :=, dạng ngắn chỉ dùng trong hàm và tự suy ra kiểu.

package main

import "fmt"

func main() {
	var city string = "Lisbon" // explicit type and value
	var year = 2026            // type inferred as int
	var score int              // no value: zero value 0
	name := "Ana"              // short declaration, inferred string

	fmt.Println(city, year, score, name)
	fmt.Printf("%T %T %T %T\n", city, year, score, name)
}

Mỗi biến có một kiểu cố định được quyết định lúc biên dịch. Khi bạn cho giá trị, Go suy ra kiểu từ giá trị đó, nên viết thêm kiểu (var city string = "Lisbon") vẫn hợp lệ nhưng thừa.

var và :=

Lựa chọn chuẩn trong một hàm:

• x := value khi bạn có giá trị khởi đầu.
• var x T khi bạn muốn giá trị zero, như một cách nói "cố ý để trống": var buf bytes.Buffer, var total int.
• var x T = value khi kiểu được suy ra không phải kiểu bạn muốn, ví dụ var ratio float64 = 1 (viết ratio := 1 sẽ ra int).

Dùng := bên ngoài hàm là lỗi cú pháp:

./main.go:5:1: syntax error: non-declaration statement outside function body

Giá trị zero

Biến khai báo không kèm giá trị không bao giờ chứa rác. Nó giữ giá trị zero của kiểu:

package main

import "fmt"

type Point struct {
	X, Y int
}

func main() {
	var i int
	var f float64
	var b bool
	var s string
	var p *int
	var sl []int
	var m map[string]int
	var pt Point

	fmt.Println(i, f, b, s == "", p, sl == nil, m == nil, pt)
	fmt.Println(len(sl), len(m), m["missing"])
}

Các API Go tốt được thiết kế để giá trị zero dùng được ngay: sync.Mutex zero đang ở trạng thái mở khóa, bytes.Buffer zero rỗng và sẵn sàng, còn len, range và append đều chạy được trên slice nil. Thứ cần để ý là map: đọc map nil trả về giá trị zero, nhưng ghi vào nó sẽ gây panic. Hãy tạo map bằng make hoặc literal trước khi ghi dữ liệu vào.

Khai báo nhiều biến

package main

import "fmt"

var (
	appName = "inventory"
	version = "1.4.0"
	debug   bool
)

func main() {
	var width, height int = 1920, 1080
	x, y := 3, 4
	first, count := "widget", 12

	fmt.Println(appName, version, debug)
	fmt.Println(width, height, x, y, first, count)

	// swap without a temporary variable
	x, y = y, x
	fmt.Println("after swap:", x, y)
}

Khối var ( ... ) gom các biến cấp package có liên quan lại với nhau. Trong phép gán nhiều biến như x, y = y, x, mọi biểu thức bên phải được tính xong trước khi gán bất cứ thứ gì, nhờ vậy phép hoán đổi mới chạy đúng.

:= với nhiều tên không khai báo lại gì cả, miễn là ít nhất một tên bên trái là mới. Các tên đã có trong cùng phạm vi chỉ đơn giản được gán giá trị. Nhờ thế bạn dùng lại được err:

f, err := os.Open("a.txt")   // declares f and err
g, err := os.Open("b.txt")   // declares g, assigns to the existing err

Nếu không có tên nào mới, đó là lỗi:

./main.go:7:4: no new variables on left side of :=

Dùng = thường để gán cho biến đã tồn tại.

Biến không dùng đến là lỗi

Một biến cục bộ được khai báo nhưng không bao giờ được đọc sẽ làm build thất bại:

./main.go:9:2: declared and not used: x

Đây không phải cảnh báo mà bạn tắt đi được. Hãy xóa biến, dùng nó, hoặc khi đang gỡ lỗi thì làm nó im bằng định danh trống: _ = x. Định danh trống còn dùng để bỏ đi các giá trị trả về bạn không cần: _, err := fmt.Println("hi").

Biến cấp package và tham số hàm không bị áp quy tắc này.

Phạm vi và shadowing

Một biến tồn tại từ chỗ khai báo đến hết khối bao quanh nó ({ ... }). Một := trong khối bên trong tạo ra một biến mới, kể cả khi bên ngoài đã có biến cùng tên. Biến bên ngoài bị che khuất (shadowing), chứ không bị thay đổi:

package main

import (
	"fmt"
	"strconv"
)

func main() {
	count := 0
	input := "42"

	if input != "" {
		count, err := strconv.Atoi(input) // new count, only inside this block
		if err != nil {
			fmt.Println("error:", err)
			return
		}
		fmt.Println("inside:", count)
	}

	fmt.Println("outside:", count) // still 0
}

Chương trình in ra inside: 42 rồi outside: 0. := bên trong if đã khai báo cả count lẫn err là biến mới trong khối bên trong, vì ở đó chưa có biến nào trong hai biến này. Code biên dịch không một lỗi nào, và đây là nguồn gốc kinh điển của những bug kiểu "giá trị của mình biến đâu mất".

Cách sửa là khai báo err trước rồi gán bằng =:

var err error
count, err = strconv.Atoi(input)

Mặc định go vet không báo shadowing. Bộ phân tích shadow riêng thì có, và các linter như golangci-lint có thể bật nó lên.

Đặt tên

• Dùng camelCase: maxRetries, userID. Không dùng max_retries.
• Giữ chữ viết tắt ở cùng một kiểu chữ: userID, httpClient, parseURL, không phải userId.
• Tên ngắn cho phạm vi ngắn: i trong vòng lặp, r cho một reader, err cho lỗi. Tên dài, mô tả rõ hơn cho biến cấp package.
• Tên viết hoa chữ cái đầu ở cấp package (var Timeout) được export sang các package khác. Xem trang package và import.

Biến cấp package

Biến khai báo bên ngoài hàm tồn tại suốt chương trình và được khởi tạo trước khi main chạy, theo thứ tự phụ thuộc. Chúng tiện cho cấu hình và cache, và được mọi goroutine dùng chung. Nếu có nhiều hơn một goroutine ghi vào cùng một biến, hãy bảo vệ nó bằng mutex hoặc dùng sync/atomic, nếu không bạn sẽ gặp data race.

Với những giá trị không bao giờ đổi, nên dùng hằng số. Một const không thể bị sửa nhầm và không tốn gì lúc chạy.