Seal Courses/Modern Go Engineering Practices
go.dev

Opinionated Go 2026

Modern Go Engineering Practices

คอร์สแบบ opinionated สำหรับคนที่เขียน Go พื้นฐานได้แล้วและต้องการสร้าง service ที่อ่านง่าย ทดสอบได้ หยุดได้ และดูแลได้บน production พร้อมบอก default library ที่ควรรู้ เหตุผลที่เลือก และจุดที่ควรกลับมาใช้ standard library

28 บทเรียน7 partsSoftware Engineering

Course trail

เส้นทางการเรียน

Part 1 — Foundations and Judgment

บทที่ 1Go Conventions and Engineering Judgmentเข้าใจว่า Go กำหนดอะไรไว้แล้ว convention เกิดตรงไหน และตัดสินอย่างไรเมื่อไม่มีคำตอบเดียวบทที่ 2Readable Goตั้งชื่อ จัด control flow และออกแบบโค้ดจากมุมคนเรียก โดยให้เครื่องมือดูแล formatting

Part 2 — Opinionated Go Style Guide

บทที่ 3Style Decisions in Practiceกลั่น Google และ Uber Go style guides เป็น course defaults พร้อมข้อยกเว้นและโจทย์ code reviewบทที่ 4Naming, Documentation and Importsตั้งชื่อ package และ symbol เขียน API docs และจัด imports จากมุมของผู้ใช้ packageบทที่ 5Values, Initialization and Control Flowเลือก declaration, zero value, nil, copying, defer และ control flow โดยเห็น semantics ที่ซ่อนอยู่บทที่ 6APIs, Interfaces and Program Structureออกแบบ constructor, interface, embedding, global state และ package structure ให้ contract แคบและชัดบทที่ 7Errors, Concurrency and Testing Styleกำหนด house style สำหรับ error, context, goroutine และ test โดยไม่ซ่อน failure หรือ lifecycle

Part 3 — Language and Data Semantics

บทที่ 8Values, Pointers and Ownershipเข้าใจ copy, aliasing, receiver, zero value และสัญญาว่าใครแก้หรือเก็บข้อมูลได้บทที่ 9Modern Collectionsใช้ slices, maps, iterators และ samber/lo โดยไม่ซ่อน cost หรือสร้าง pipeline ที่อ่านยาก

Part 4 — APIs and Boundaries

บทที่ 10Packages as APIsออกแบบ package จาก client code, รักษา dependency direction และสร้าง interface ฝั่ง consumerบทที่ 11Construction and Compatibilityเลือก zero value, constructor, config struct, functional options และ DI ให้เหมาะกับ lifecycleบทที่ 12Interfaces, Generics and Reflectionเลือก abstraction จากชนิดของความแปรผัน แทนการใช้ interface หรือ generics กับทุกปัญหาบทที่ 13Errors as Public Contractsออกแบบ error vocabulary, wrapping, translation และ structured errors ที่สังเกตได้ข้าม boundaryบทที่ 14Context, Resources and Cancellationส่ง deadline และ cancellation ให้ถึงปลายทาง พร้อมจัดลำดับ cleanup และไม่ซ่อน lifecycleบทที่ 15HTTP APIs, Routers and OpenAPIเลือก ServeMux, Chi, Gin, Echo หรือ Fiber และวาง oapi-codegen เป็น contract boundary ที่ถูกต้อง

Part 5 — Concurrency That Stops

บทที่ 16The Go Memory Modelเข้าใจ happens-before, data race และเหตุผลที่โค้ดซึ่งดู atomic อาจยังไม่ถูกต้องบทที่ 17Goroutine Ownershipทุก goroutine ต้องมีเจ้าของ เงื่อนไขหยุด และเส้นทางส่งผลลัพธ์หรือความผิดพลาดกลับบทที่ 18Synchronization and Backpressureเลือก mutex, channel, atomic และ bounded queue จาก invariant ไม่ใช่จากความชอบ

Part 6 — Evidence-Driven Quality

บทที่ 19Unit Testing in Goเขียน table tests, fixtures, builders, harnesses, assertions และ mocks ที่ไม่ผูกกับ implementationบทที่ 20Testing Concurrent Codeทดสอบ cancellation, ordering และ time-based behavior แบบ deterministic ด้วย synctest และ race detectorบทที่ 21Fuzzing and Secure Boundariesใช้ fuzzing ตรวจ parser และ untrusted input พร้อมกำหนด limits ก่อนข้อมูลเข้าสู่ business logicบทที่ 22Tool-Driven Reviewสร้าง feedback loop จาก fmt, vet, static analysis, govulncheck, coverage และ CI matrixบทที่ 23Organization-Wide Go Standardsแยก standard, contract, tooling, template และ private module เพื่อหยุด contract drift ข้ามหลาย codebaseบทที่ 24AI-Assisted Go Engineeringใช้ AI สร้าง change ภายใต้ contract, deterministic feedback, human review และผลลัพธ์ที่วัดได้

Part 7 — Production Engineering

บทที่ 25Runtime-Aware MySQL and Redis Clientsตั้ง connection pools ต่างกันสำหรับ HTTP service, Lambda และ Temporal Worker โดยวัดจาก concurrency จริงบทที่ 26Service Lifecycle and Observabilityประกอบ application, readiness, graceful shutdown, slog, metrics และ traces ให้มี ownership เดียวกันบทที่ 27Measure, Profile and Optimizeใช้ benchmark, benchstat, pprof, trace, PGO และ GC evidence ก่อนแก้ performanceบทที่ 28Production Readiness Capstoneรวม OpenAPI, Chi, MySQL, Redis, worker, tests, observability และ operational limits ในบริการเดียว

วิธีอ่านคอร์สนี้

คอร์สนี้เป็น opinionated course ไม่ใช่เอกสารทางการของภาษา Go จุดประสงค์จึงไม่ใช่ การรวบรวมทุก syntax แต่คือช่วยให้คนที่เริ่มทำงานกับ Go ตัดสินใจได้ว่า production code ควรเขียนอย่างไร ใช้ library ใด และต้องพิสูจน์อะไรด้วย test หรือเครื่องมือ

  • Part 1 วางฐานเรื่อง convention, readability และ engineering judgment
  • Part 2 กลั่น Google และ Uber guides เป็น opinionated house style ที่ใช้ review ได้
  • Part 3 อธิบาย value, pointer, ownership และ collections ด้วย language semantics
  • Part 4 เปลี่ยนฐานเหล่านั้นเป็น package, API, error, context และ HTTP boundary
  • Part 5 สร้าง concurrency ที่อธิบายได้ว่าใครเริ่ม ใครหยุด และรับ load ได้เท่าไร
  • Part 6 ใช้ test, fuzzing, toolchain, organizational standards และ AI-assisted workflow สร้างหลักฐานว่า behavior ที่ออกแบบไว้ยังถูกต้อง
  • Part 7 เชื่อม MySQL, Redis, runtime lifecycle, observability และ performance เข้าด้วยกัน

ควรอ่านเรียงลำดับอย่างน้อยถึงบทที่ 18 หลังจากนั้นสามารถเลือกบทตามงานได้ แต่บท Capstone จะสมมติว่าคุณเข้าใจ contract, cancellation, bounded concurrency และ testing จากบทก่อนหน้าแล้ว

กลุ่มเป้าหมายและ baseline

ผู้อ่านควรเขียน function, struct, method, interface, goroutine และ test พื้นฐานได้ ตัวอย่างหลักกำหนด module ที่ go 1.25.0 และให้ใช้ latest patch ของ Go 1.26 เป็น toolchain ขณะเรียน เพื่อให้เห็น feature ปัจจุบันโดยยังทดสอบ compatibility กับ Go major ที่ support อยู่

Version เป็นส่วนหนึ่งของคำแนะนำ

Go, framework และ library เปลี่ยนต่อเนื่อง สถานะในคอร์สตรวจเมื่อ 12 สิงหาคม 2026 ก่อนนำ version หรือ API ไปใช้จริงต้องยืนยันกับ release notes และ security advisory อีกครั้ง ส่วน Go 1.27 ที่ยังเป็น draft ในวันที่ตรวจจะถูกพูดถึงเป็น release radar เท่านั้น

Running Project: Settlement Job Service

ทุกบทจะค่อย ๆ สร้าง mental model ของบริการสมมติชื่อ settlement บริการนี้รับ HTTP request เพื่อสร้าง batch, อ่านข้อมูลจาก MySQL, ใช้ Redis เก็บ derived state สำหรับหน้า status และส่งงาน ให้ worker ประมวลผลแบบจำกัด concurrency ใน Capstone เราจะประกอบสิ่งเหล่านี้เป็น service เดียว โดยไม่อ้างว่ามี folder structure หนึ่งที่เหมาะกับทุกทีม

MySQL เป็น authoritative state ของ batch ส่วน Redis เป็น cache หรือ read model ที่สร้างใหม่ได้ การตัดสินใจที่เปลี่ยนสถานะธุรกิจต้องอ่านและเขียนผ่าน authoritative boundary เสมอ

House Style และระดับของคำแนะนำ

เราใช้ Effective Go เป็นรากด้าน idiom แต่หน้าเอกสารระบุเองว่า ไม่ได้อัปเดตอย่าง active และไม่ครอบคลุม ecosystem สมัยใหม่ จึงประกบด้วย Google Go Style, Uber Go Style Guide, Go specification, package documentation, release notes และหลักฐานจาก production codebase บางแห่ง เช่น CockroachDB และ Kubernetes

ข้อความสำคัญจะแยกเป็น 4 ระดับ:

  1. Guarantee — สิ่งที่ language specification, memory model หรือ package contract รับรอง
  2. Recommended default — คำตอบเริ่มต้นของคอร์สสำหรับงาน production ทั่วไป
  3. Course convention — ข้อตกลงเพื่อให้ตัวอย่างทั้งคอร์สสม่ำเสมอ
  4. Trade-off — จุดที่ workload, team หรือ runtime อาจทำให้คำตอบเปลี่ยน

กฎจาก style guide จะไม่ถูกยกมาเป็นกฎของภาษา เช่น line length แบบตายตัวเป็น team convention ไม่ใช่ Go guarantee และคำแนะนำเก่าเรื่อง loop variable หรือ atomic operations ต้องตรวจเทียบกับ Go version ปัจจุบันก่อนเสมอ

Production Toolbox

จุดยืนของคอร์สคือ ใช้ established default และเข้าใจว่ามันทดแทนอะไร ถ้า standard library ตอบโจทย์ชัดเจน เราจะใช้มัน แต่ถ้า library ที่ mature ช่วยลดโค้ดซ้ำ ทำ contract ชัดขึ้น หรือปิดช่องผิดพลาดได้จริง เราจะบอกชื่อ library ไปตรง ๆ ไม่ปล่อยให้ผู้เรียนต้องค้นเองใหม่

แต่ละตัวเลือกจะถูกอธิบายด้วยคำถามชุดเดียวกัน: default คืออะไร, มันทดแทนอะไร, ใช้เมื่อไร, ควรหลีกเลี่ยงเมื่อไร, มี operational cost อะไร และมีทางเลือกใดบ้าง ตัวอย่างที่พบในคอร์สมี samber/lo, samber/do, samber/oops, samber/slog-multi, go-cmp, testify, oapi-codegen, go-redis/v9 และ testcontainers-go ส่วน samber/mo, ro และ hot จะเป็นเครื่องมือเฉพาะทาง ไม่ใช่ default ของทุกโปรเจกต์

เป้าหมายหลังเรียนจบ

คุณควร review Go service ได้โดยอธิบายจาก contract, ownership, lifecycle และ evidence ไม่ใช่ตอบเพียงว่า “ทีมอื่นก็เขียนแบบนี้” และควรรู้จัก library เจ้าประจำมากพอที่จะเลือกใช้ หรือปฏิเสธมันด้วยเหตุผลที่ตรวจสอบได้

แหล่งอ้างอิงหลัก

แหล่ง community ถูกใช้เป็นคำแนะนำและ production witness ไม่ใช่ authority ที่เหนือ specification เมื่อแหล่งข้อมูลขัดกัน คอร์สจะแสดง trade-off และประกาศ course default ให้ชัดเจน

คำอธิบายและตัวอย่างในคอร์สเขียนขึ้นใหม่โดยอ้าง provenance ของแต่ละแนวคิด Google styleguide เผยแพร่ ภายใต้ CC BY 3.0 และ Uber Go Style Guide เผยแพร่ภายใต้ Apache License 2.0 การอ้างชื่อใช้เพื่อบอกแหล่งที่มา เท่านั้น ไม่ได้หมายความว่าองค์กรดังกล่าวรับรองคอร์สนี้