gofmt, go vet และ Linting

Prettier + ESLint + tsc → gofmt + go vet + staticcheck

ในโลก TypeScript คุณต้องใช้เครื่องมือสามตัวแยกกันเพื่อครอบคลุมการจัดรูปแบบ รูปแบบที่เสี่ยงต่อบัก และ type error:

Prettier จัดรูปแบบโค้ดให้สม่ำเสมอ
ESLint ตรวจจับรูปแบบที่น่าสงสัยและบังคับใช้ convention
tsc (type-checker) รายงาน type error

Go ยุบทั้งหมดนี้ไว้ในเครื่องมือที่เป็นส่วนหนึ่งของการติดตั้ง Go มาตรฐาน เสริมด้วย linter จาก third-party (staticcheck หรือ golangci-lint) ที่ชุมชนใช้กันแทบทุกที่

gofmt — formatter แบบมีความเห็นชัดเจน

gofmt (หรือ alias go fmt) เขียนทับไฟล์ source ของคุณ in-place เพื่อให้ตรงกับ Go style หนึ่งเดียว ต่างจาก Prettier ตรงที่ ไม่มี configuration ให้ปรับเลย ไม่มี .gofmtrc, ไม่มี printWidth, ไม่มี option singleQuote

# จัดรูปแบบทุก package ใน module
go fmt ./...

# Preview ว่าจะเปลี่ยนอะไร (dry-run)
gofmt -d .

# เขียนการเปลี่ยนแปลง in-place
gofmt -w .

Editor ส่วนใหญ่รัน gofmt อัตโนมัติตอน save ถ้าใช้ VS Code แค่ติดตั้ง Go extension ตัวทางการ ก็ทำงานได้เลยโดยไม่ต้อง config อะไรเพิ่ม

// .prettierrc
{
  "semi": true,
  "singleQuote": false,
  "printWidth": 100,
  "tabWidth": 2,
  "trailingComma": "es5"
}

// รัน:
// npx prettier --write src/

# ไม่ต้องมี config file
# รัน:
go fmt ./...

# หรือเชื่อมกับ "format on save" ของ editor
# ผลลัพธ์จะเหมือนกันเสมอไม่ว่าใครจะรัน

go vet — ตัวตรวจจับบัก

go vet คือ static analyser ที่มาพร้อมกับ Go คอยหาบั๊กจริง ๆ ไม่ใช่แค่ปัญหา style เช่น:

การส่ง type ผิดให้ format string ของ fmt.Printf
โค้ดที่รันไปไม่ถึงหลัง return
struct tag ที่เขียนผิดรูปแบบ
การ copy mutex แบบ by value

go vet ./...

ให้นึกถึงเป็น subset ของ ESLint rule ที่จับความผิดพลาดจริง ๆ ไม่ใช่ preference ด้าน style

// ESLint (ส่วนหนึ่งของ .eslintrc.json)
{
  "rules": {
    "no-unreachable": "error",
    "no-unused-vars": "error",
    "@typescript-eslint/no-explicit-any": "warn"
  }
}

// รัน:
// npx eslint src --ext .ts

# ไม่ต้อง config
go vet ./...

# ตัวอย่าง output เมื่อมีปัญหา:
# ./main.go:12:2: Printf format %d has arg name of wrong type string

staticcheck และ golangci-lint

go vet จับบักที่ชัดเจนที่สุด ส่วนการตรวจที่ครอบคลุมกว่า — exports ที่ไม่ถูกใช้, การใช้ deprecated API, โค้ดที่เขียนให้สั้นลงได้ — ชุมชนจะพึ่ง:

staticcheck (honnef.co/go/tools) — linter แบบ focused ที่มี signal สูง
golangci-lint — meta-linter ที่รัน linter หลายตัวพร้อมกัน รวมถึง staticcheck, errcheck, gosimple และอื่น ๆ

# ติดตั้ง staticcheck
go install honnef.co/go/tools/cmd/staticcheck@latest

# รัน
staticcheck ./...

# หรือใช้ golangci-lint (แนะนำสำหรับ CI)
# ติดตั้ง: https://golangci-lint.run/usage/install/
golangci-lint run ./...

.golangci.yml เริ่มต้นที่แนะนำ:

linters:
  enable:
    - staticcheck
    - errcheck
    - gosimple
    - unused

linters-settings:
  staticcheck:
    go: "1.22"

รันคำสั่งพวกนี้ใน terminal หลังติดตั้ง golangci-lint ตัว linter ไม่มีเวอร์ชันที่รันบน browser

🟦 Style เดียว — ไม่มีการทะเลาะเรื่อง style อีกต่อไป

ผลกระทบทางวัฒนธรรมที่สำคัญที่สุดของ gofmt คือ โค้ดเบส Go ทุกที่ดูเหมือนกัน เมื่อคุณเปิด Go repo ที่ไม่คุ้นเคยบน GitHub คุณอ่านได้ทันทีเพราะการจัดรูปแบบเหมือนกับ project ของคุณเอง

ใน TypeScript แต่ละ project มี Prettier config, ESLint config และบางครั้งมีการผสมทั้งสองแบบเอง แรงเสียดทานในการ onboard เพิ่มขึ้นทุกครั้งที่มี config file ใหม่ที่นักพัฒนาต้องเรียนรู้

Go ตัดปัญหานี้ทิ้งไปทั้งหมด Style เป็นส่วนหนึ่งของภาษา และ pull request ไม่เคยติดอยู่กับการ nitpick เรื่อง format