Hướng dẫn dùng AI

Viết Go cùng AI: bốn cái bẫy và hai công cụ có sẵn để bắt chúng

Go được dùng nhiều cho máy chủ, công cụ dòng lệnh và hệ thống đám mây, và nhờ cú pháp gọn, code Go do AI viết thường đọc rất dễ. Nhưng Go có vài quy tắc riêng mà code trông hợp lý vẫn có thể vi phạm: một map chưa khởi tạo, nhiều goroutine cùng sửa một biến, một lỗi bị gạt đi bằng dấu gạch dưới. Bài này đi qua bốn cái bẫy hay gặp trong code Go do AI viết, đối chiếu với tài liệu chính thức của Go, và chỉ cách dùng hai công cụ có sẵn trong bộ cài Go là go vet và bộ phát hiện tranh chấp dữ liệu để bắt chúng, chạy thử trên Go 1.27.4.

Ý chính
  • Đặc tả Go: map nil giống map rỗng nhưng không thêm được phần tử; ghi vào đó làm chương trình dừng với panic. Tạo map bằng make.
  • Nhiều goroutine cùng sửa một biến mà không khóa cho kết quả sai và đổi mỗi lần chạy; go run -race báo "WARNING: DATA RACE".
  • Gạt lỗi đi bằng dấu gạch dưới làm dữ liệu sai lọt qua im lặng; kiểm err ngay sau mỗi lời gọi trả lỗi.
  • go vet bắt nhiều lỗi mà trình biên dịch để lọt, như Printf sai số đối số. Còn ý nghĩa biến vòng lặp phụ thuộc dòng go trong go.mod.

Code trong bài là Go; phần kiểm viết bằng Python, chạy go vet, go run và go run -race của Go 1.27.4 trên hai chương trình và so với kết quả làm tay.

Vì sao code Go của AI cần soát

Trình biên dịch Go khá nghiêm: biến khai báo mà không dùng, import thừa đều bị báo lỗi, không cho chạy. Nhờ vậy code Go do AI viết thường biên dịch được ngay. Nhưng có những lỗi chỉ lộ ra lúc chạy, hoặc không lộ ra rõ ràng mà chỉ cho kết quả sai. Go cung cấp sẵn công cụ cho đúng những lỗi đó, và thói quen chạy chúng quan trọng hơn việc đọc kỹ từng dòng.

Nếu bạn viết máy chủ bằng Go, các thói quen an toàn trong bài Node.js cùng AI, như giữ khóa ngoài mã và không ghép dữ liệu người dùng vào lệnh, vẫn áp dụng y nguyên.

Bẫy 1: ghi vào map nil

Đặc tả ngôn ngữ Go ghi: map nil tương đương map rỗng, chỉ khác là không thêm được phần tử nào. Khai báo var dem map[string]int mà quên make, rồi ghi dem[t]++, chương trình dừng với thông báo "panic: assignment to entry in nil map". Đọc từ map nil thì không sao, nên đoạn code có thể chạy được một phần trước khi gặp dòng ghi đầu tiên.

Cách sửa: tạo map bằng make(map[string]int), hoặc viết dạng map rỗng có ngoặc nhọn. Khi một struct có trường kiểu map, nhớ khởi tạo trường đó trong hàm tạo.

Bẫy 2: goroutine tranh nhau một biến

Go làm việc song song rất dễ: thêm chữ go trước lời gọi hàm. Code AI hay dùng điều này để "chạy cho nhanh", rồi cho mọi goroutine cùng cộng vào một biến. Phép tăng một đơn vị không phải thao tác nguyên tử: đọc, cộng, ghi; hai goroutine chen nhau thì mất một lần cộng. Trong ví dụ của bài, 1.000 goroutine mỗi cái cộng 1, kết quả in ra 989 ở một lần chạy, 949 ở lần khác, không lần nào chắc đúng 1.000.

Go có sẵn bộ phát hiện tranh chấp dữ liệu: chạy go run -race hay go test -race. Tài liệu Go ghi bộ này cần bật cgo và, trên hệ không phải macOS, cần có trình biên dịch C; nó hỗ trợ windows/amd64 cùng nhiều hệ Linux, macOS khác. Với ví dụ của bài, -race in "WARNING: DATA RACE" kèm vị trí hai goroutine cùng truy cập. Cách sửa: khóa bằng sync.Mutex quanh chỗ ghi, dùng kiểu trong gói sync/atomic, hoặc để mỗi goroutine gửi kết quả qua channel cho một nơi gom.

Bẫy 3: gạt lỗi đi bằng dấu gạch dưới

Hàm Go báo lỗi bằng giá trị trả về thứ hai. Code AI viết để "chạy cho gọn" hay nhận lỗi vào dấu gạch dưới: so, _ := strconv.Atoi(chu). Khi chuỗi là "12a", Atoi trả lỗi cùng giá trị 0, và chương trình dùng số 0 đó như dữ liệu thật. Không có gì dừng lại, không có dòng báo lỗi nào; một điểm số, một số lượng hàng bị thay bằng 0 mà không ai biết.

Cách sửa: luôn kiểm err ngay sau lời gọi, và trả lỗi lên trên kèm ngữ cảnh, như fmt.Errorf với %w để giữ lỗi gốc. Khi đọc code AI viết, tìm mọi dấu gạch dưới đứng ở vị trí giá trị lỗi.

Bẫy 4: biến vòng lặp và dòng go trong go.mod

Trước Go 1.22, biến của vòng for được dùng chung cho mọi vòng; hàm hay goroutine tạo trong vòng lặp mà dùng biến đó đều thấy giá trị cuối cùng. Blog Go "Fixing For Loops in Go 1.22" gọi đây là một trong những lỗi Go phổ biến nhất, và từ Go 1.22 mỗi vòng có biến riêng. Điểm cần nhớ: theo bài blog, ngữ nghĩa mới chỉ áp dụng cho các gói thuộc module khai báo go 1.22 trở lên trong tệp go.mod.

Ví dụ của bài tạo ba hàm trong vòng lặp, mỗi hàm trả về i. Cùng mã nguồn, chạy bằng cùng Go 1.27.4: go.mod ghi go 1.21 thì in [3 3 3], ghi go 1.27 thì in [0 1 2]. Vì mô hình học từ nhiều code cũ, nó có thể thêm dòng i := i không cần thiết, hoặc ngược lại bỏ đi khi dự án của bạn vẫn khai báo bản cũ. Hãy kiểm dòng go trong go.mod trước khi tin vào giải thích của AI.

go vet

go vet là công cụ soát đi kèm Go, tìm những đoạn code biên dịch được nhưng gần như chắc chắn sai. Trang tài liệu cmd/vet liệt kê các phép kiểm như printf, kiểm chuỗi định dạng của Printf có khớp với đối số không. Chương trình ví dụ có một lời gọi Printf với một chỗ %s nhưng truyền hai đối số; go vet báo đúng dòng đó. Chạy go vet ./... cho cả dự án trước mỗi lần nộp hay đẩy code.

Chạy thử

Chương trình dưới đây chứa các bẫy ở trên, chọn bằng đối số dòng lệnh: map, dem, loi hoặc vonglap. Dòng Printf cuối cố tình thừa một đối số để go vet bắt.

// Bốn cái bẫy Go hay gặp trong code do AI viết. Chọn bẫy bằng đối số: map | dem | loi | vonglap.
// Soát: go vet ./...   Chạy kèm bộ phát hiện tranh chấp: go run -race . dem
package main

import (
	"fmt"
	"os"
	"strconv"
	"sync"
)

// 1. Ghi vào map nil: theo đặc tả Go, map nil không thêm được phần tử nào -> panic lúc chạy.
func demTu(tu []string) map[string]int {
	var dem map[string]int // quên make
	for _, t := range tu {
		dem[t]++
	}
	return dem
}

// 2. Nhiều goroutine cùng tăng một biến mà không khóa: kết quả thiếu, -race báo DATA RACE.
func demSongSong(n int) int {
	tong := 0
	var wg sync.WaitGroup
	for i := 0; i < n; i++ {
		wg.Add(1)
		go func() {
			defer wg.Done()
			tong++
		}()
	}
	wg.Wait()
	return tong
}

// 3. Bỏ qua lỗi bằng dấu gạch dưới: chuyển chuỗi lỗi thành 0 mà không ai biết.
func docSo(chu string) int {
	so, _ := strconv.Atoi(chu)
	return so
}

// 4. Hàm tạo trong vòng lặp: kết quả phụ thuộc dòng "go" trong go.mod (1.22 trở lên: mỗi vòng một biến).
func hamTrongVongLap() []int {
	var cacHam []func() int
	for i := 0; i < 3; i++ {
		cacHam = append(cacHam, func() int { return i })
	}
	var kq []int
	for _, f := range cacHam {
		kq = append(kq, f())
	}
	return kq
}

func main() {
	bay := ""
	if len(os.Args) > 1 {
		bay = os.Args[1]
	}
	switch bay {
	case "map":
		fmt.Println(demTu([]string{"go", "ai", "go"}))
	case "dem":
		fmt.Println("tong =", demSongSong(1000))
	case "loi":
		fmt.Println("docSo(\"12a\") =", docSo("12a"))
	case "vonglap":
		fmt.Println(hamTrongVongLap())
	}
	fmt.Printf("xong %s\n", bay, len(os.Args)) // 5. thừa đối số cho Printf: go vet bắt được
}

Bản đã sửa tạo map bằng make, khóa bằng mutex khi đếm song song, trả lỗi kèm ngữ cảnh, và gọi Printf đúng số đối số.

// Bản đã sửa: make map, khóa khi nhiều goroutine cùng ghi, xử lý lỗi, Printf đúng số đối số.
package main

import (
	"fmt"
	"strconv"
	"sync"
)

func demTu(tu []string) map[string]int {
	dem := make(map[string]int)
	for _, t := range tu {
		dem[t]++
	}
	return dem
}

func demSongSong(n int) int {
	tong := 0
	var mu sync.Mutex
	var wg sync.WaitGroup
	for i := 0; i < n; i++ {
		wg.Add(1)
		go func() {
			defer wg.Done()
			mu.Lock()
			tong++
			mu.Unlock()
		}()
	}
	wg.Wait()
	return tong
}

func docSo(chu string) (int, error) {
	so, err := strconv.Atoi(chu)
	if err != nil {
		return 0, fmt.Errorf("đọc %q: %w", chu, err)
	}
	return so, nil
}

func main() {
	fmt.Println(demTu([]string{"go", "ai", "go"}))
	fmt.Println("tong =", demSongSong(1000))
	if _, err := docSo("12a"); err != nil {
		fmt.Println("lỗi:", err)
	}
	fmt.Printf("xong %d\n", 4)
}

Phần kiểm đi kèm chạy trên Go 1.27.4 ngày 12/11/2026: go vet báo lỗi Printf ở dòng 70; bẫy map dừng với panic đúng như đặc tả; bẫy lỗi in 0 cho chuỗi "12a"; bẫy vòng lặp in [0 1 2] với go 1.27 và [3 3 3] với go 1.21; go run -race với bẫy đếm in cảnh báo tranh chấp. Bản sửa qua go vet, chạy với -race không có cảnh báo, đếm đúng 1.000, đếm từ ra go 2 lần và ai 1 lần như đếm tay.

Bốn bẫy Go Theo tài liệu Go, chạy thử bằng go1.27.4, 12/11/2026 Map nilGhi vào là panic:dùng make GoroutineGhi chung biến:go run -race Bỏ qua lỗiDấu _ giấu lỗi:xử lý err PrintfSai đối số:go vet báo go vet và -race trước mỗi lần nộp
Bốn bẫy Go Map nilGhi vào là panic:dùng make GoroutineGhi chung biến:go run -race Bỏ qua lỗiDấu _ giấu lỗi:xử lý err PrintfSai đối số:go vet báo go vet và -race trước mỗi lần nộp
Hình 1. Bốn bẫy Go hay gặp trong code do AI viết: ghi vào map nil gây panic, dùng make; goroutine ghi chung một biến, go run -race bắt; dấu gạch dưới giấu lỗi, hãy xử lý err; Printf sai đối số, go vet báo.

Làm việc với AI khi viết Go

  • Chạy go vet và go test -race thường xuyên. Dán nguyên văn cảnh báo cho AI sửa.
  • Hỏi vì sao cần goroutine. Nhiều đoạn code không cần chạy song song; code tuần tự đơn giản hơn và không có tranh chấp. Nếu cần, yêu cầu AI nói rõ dữ liệu nào được chia sẻ và được bảo vệ thế nào.
  • Tìm dấu gạch dưới. Mỗi chỗ nhận lỗi vào dấu gạch dưới cần một lý do.
  • Cho AI biết bản Go và dòng go trong go.mod. Tránh giải thích theo ngữ nghĩa cũ của vòng lặp, hay dùng thư viện chuẩn chưa có ở bản bạn cài.
  • Viết test. Go có sẵn go test; bài AI viết test tự động có cách nhờ AI sinh test mà vẫn tự kiểm được test đó.

Ví dụ: công cụ đếm từ trong bài nộp

Bạn nhờ AI viết một công cụ Go đọc nhiều tệp bài nộp cùng lúc và đếm số lần xuất hiện của từng từ khóa. AI dùng một goroutine cho mỗi tệp, cùng ghi vào một map chung khai báo bằng var, và bỏ qua lỗi khi mở tệp. Chạy lần đầu, chương trình dừng vì ghi vào map nil. Sửa bằng make, chương trình lại thỉnh thoảng dừng với thông báo ghi đồng thời vào map. Bạn chạy go run -race: cảnh báo tranh chấp chỉ đúng dòng ghi vào map. Bạn thêm mutex, kiểm lỗi khi mở tệp để biết tệp nào không đọc được, rồi chạy go vet và -race lần nữa: sạch. Kết quả đếm giờ giống nhau mọi lần chạy.

Cẩn thận
  • Khai báo map bằng var rồi ghi vào mà không make.
  • Cho nhiều goroutine cùng sửa biến hay map mà không khóa.
  • Nhận lỗi vào dấu gạch dưới để code ngắn hơn.
  • Không chạy go vet và -race trước khi nộp.
  • Tin giải thích của AI về biến vòng lặp mà không xem dòng go trong go.mod.
  • Thấy chương trình chạy đúng một lần rồi coi như không có tranh chấp dữ liệu.

Câu hỏi thường gặp

Vì sao ghi vào map trong Go bị panic?

Map chưa make là map nil, đọc được nhưng không thêm phần tử được; hãy tạo bằng make.

Làm sao phát hiện data race trong Go?

Chạy go run -race hoặc go test -race; cần bật cgo và có trình biên dịch C.

go vet dùng để làm gì?

Tìm code biên dịch được nhưng gần như chắc chắn sai, như Printf sai số đối số.

Biến vòng lặp trong Go đổi thế nào từ Go 1.22?

Mỗi vòng có biến riêng, nhưng chỉ với module khai báo go 1.22 trở lên trong go.mod.

Học tiếp

Nếu bạn muốn học Python và AI bài bản cùng giảng viên, tham khảo khóa học AI của Big-O Coding.

Muốn học bài bản cùng giảng viên?

Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.

Xem Khóa AI

Nguồn tham khảo

Chia sẻ: Facebook LinkedIn
Nhắn Zalo tư vấnZalo Gọi 0937 401 483