.env กับ godotenv — คนละหน้าที่กับ caarlos0/env

go version go1.26.5 darwin/arm64
github.com/joho/godotenv v1.5.1
github.com/caarlos0/env/v11 v11.4.1

1 · ปัญหาที่ .env เกิดมาแก้

ใน บทเรียน 44 เราสรุปไว้ว่า ค่า config ต้องอยู่นอกโค้ด แล้วส่งเข้ามาทาง environment variable
ซึ่งถูกต้อง — แต่พอเอามาใช้จริงตอน develop ในเครื่องตัวเอง มันกลายเป็นแบบนี้:

$ export APP_NAME=wongnok
$ export APP_ENV=development
$ export APP_PORT=8080
$ export APP_SHUTDOWN_TIMEOUT=10s
$ export LOG_LEVEL=DEBUG
# ... อีกสิบกว่าบรรทัด ...
$ go run ./cmd/api

แล้ววันรุ่งขึ้นคุณเปิด terminal ใหม่ — ต้องพิมพ์ใหม่ทั้งชุด
เพราะ environment variable ที่ export ไว้อยู่กับ shell ตัวนั้นเท่านั้น ปิด terminal ก็หายหมด (ข้อนี้ต่อจากบท 44 หัวข้อ 2 ที่พิสูจน์เรื่อง parent → child process ไว้แล้ว)
สไลด์หน้า 11 เขียนปัญหานี้ไว้ตรง ๆ ว่า: "ตอน dev ในเครื่อง ไม่มีใครอยากพิมพ์ export 15 บรรทัดใหม่ทุกครั้งที่เปิด terminal"

2 · .env หน้าตายังไง

นี่คือไฟล์ .env ตัวอย่างจากสไลด์ วางไว้ที่ root ของโปรเจกต์:

# .env — วางที่ root ของโปรเจกต์
APP_NAME=wongnok
APP_ENV=development
APP_PORT=8080
APP_SHUTDOWN_TIMEOUT=10s

LOG_LEVEL=DEBUG
LOG_FORMAT=text

POSTGRES_DSN=postgres://postgres:secret@localhost:5432/wongnok?sslmode=disable
POSTGRES_MAX_OPEN_CONNS=25
POSTGRES_CONN_MAX_LIFETIME=30m

สังเกตว่ามันไม่มี syntax อะไรเลย — ไม่มีวงเล็บ ไม่มีเครื่องหมายจบบรรทัด ไม่มี indent ที่มีความหมาย
แค่ KEY=value บรรทัดละคู่ · บรรทัดที่ขึ้นต้นด้วย # คือ comment · บรรทัดว่างข้ามไป
และค่าทุกตัวเป็นตัวอักษรล้วน — 8080 ในไฟล์นี้คือตัวอักษรสี่ตัว ไม่ใช่เลข (เรื่องนี้ยังเหมือนเดิมกับบท 44 ไม่มีอะไรเปลี่ยน)

สไลด์หน้า 11 เน้นสี่ข้อเกี่ยวกับไฟล์นี้ ซึ่งสี่ข้อนี้คือทั้งหมดที่ต้องจำ:

3 · "แค่ไฟล์ text ธรรมดา" แปลว่าอะไรกันแน่

ข้อนี้ฟังดูเหมือนคำพูดลอย ๆ แต่มันมีผลจริงที่จับต้องได้ — และเป็นสาเหตุที่คนติดกันบ่อยตอนขึ้น Docker
ผมเขียนโปรแกรมเล็ก ๆ ตัวหนึ่งที่ import _ "github.com/joho/godotenv/autoload" แล้วพิมพ์ cwd (current working directory) กับค่า env ที่ชื่อ WHERE ออกมา
จากนั้น go build -o app . ได้ binary ก้อนเดียว แล้วเอา binary ก้อนเดิมนั่นแหละ ไปรันสองที่:

p8/
├── .env          # มีบรรทัด WHERE=root-dotenv
├── app           # binary ที่ build แล้ว
└── sub/          # โฟลเดอร์ว่าง ไม่มี .env

=== run binary from project root (where .env lives) ===
cwd=/var/folders/.../p8       WHERE="root-dotenv"

=== run same binary from sub/ (no .env there) ===
cwd=/var/folders/.../p8/sub   WHERE=""

return []string{".env"}

4 · godotenv ทำงานยังไง — สองวิธี

สไลด์หน้า 12 เขียนหน้าที่ของ godotenv ไว้บรรทัดเดียวว่า "หน้าที่เดียว: อ่าน .env แล้วยัดค่าเข้า environment"
และให้สองวิธีใช้:

วิธีที่ 1 — autoload (สไลด์ชุดนี้ใช้แบบนี้)

import _ "github.com/joho/godotenv/autoload"

จบ — ไม่ต้องเรียกอะไรเพิ่มเลย
เครื่องหมาย _ ข้างหน้าเรียกว่า blank identifier import แปลว่า "เอา package นี้เข้ามา แต่ฉันไม่ได้จะเรียกฟังก์ชันอะไรของมัน — ฉันต้องการแค่ผลข้างเคียงของการ import"
ผลข้างเคียงที่ว่าคือฟังก์ชัน init() ซึ่ง Go เรียกให้อัตโนมัติทุก package ที่ถูก import

ผมเปิดซอร์สของ package autoload มาให้ดู — ทั้ง package มีแค่ 15 บรรทัดนี้จริง ๆ:

// github.com/joho/godotenv@v1.5.1/autoload/autoload.go — ทั้งไฟล์
package autoload

/*
	You can just read the .env file on import just by doing

		import _ "github.com/joho/godotenv/autoload"

	And bob's your mother's brother
*/

import "github.com/joho/godotenv"

func init() {
	godotenv.Load()
}

ผมรันยืนยันว่าแค่ import _ อย่างเดียวพอจริง ไม่ต้องเรียกอะไรเพิ่ม:

--- run 1: autoload, no shell env ---   # .env มี APP_NAME=from-dotenv, PORT=9999
APP_NAME="from-dotenv"
PORT="9999"

แล้ว "init() ทำงานก่อนสุด" หมายถึงก่อนแค่ไหน? ผมรันพิสูจน์ด้วยโปรแกรมที่มี ทั้ง package-level variable, init() ของตัวเอง และ main():

1) package-level var init: GOOD=set-by-dotenv
2) main package init(): GOOD = set-by-dotenv
3) main(): GOOD = set-by-dotenv

ลำดับที่พิมพ์ออกมาคือหลักฐานเอง — package-level variable ถูกสร้างก่อน · แล้วค่อย init() · แล้วค่อย main() และทั้งสามจุดเห็นค่าจาก .env ครบแล้ว
สิ่งที่ผลนี้พิสูจน์คือ: ค่ามาถึงตั้งแต่ตอน package-level variable ถูกสร้าง ซึ่งเกิดก่อนทุกอย่างของ package main — ไม่มีทางที่โค้ดของคุณจะทำงานก่อน autoload ได้

วิธีที่ 2 — เรียกเอง (ถ้าต้องคุมลำดับ)

สไลด์หน้า 12 เขียนไว้สามบรรทัดนี้ (เป็นเศษโค้ด ไม่ใช่ไฟล์ — เอาไปวางเดี่ยว ๆ ยังคอมไพล์ไม่ได้):

if err := godotenv.Load(); err != nil {
    slog.Debug("no .env file, using real environment")
}

สามบรรทัดนั้นถูกแล้ว แต่ยังขาด package กับ import ที่ต้องมีครอบ
นี่คือไฟล์เต็มที่ผมเอาไปรันจริงกับ godotenv v1.5.1 คู่กับ caarlos0/env v11.4.1 — ก๊อปทั้งก้อนนี้ไปวางเป็น main.go แล้ว go run . ได้เลย:

// main.go — วิธีที่ 2: เรียก godotenv.Load() เอง แล้วส่งต่อให้ caarlos0/env
package main

import (
    "fmt"
    "log/slog"
    "os"

    "github.com/caarlos0/env/v11"
    "github.com/joho/godotenv"
)

type Config struct {
    AppName string `env:"APP_NAME"`
    Port    int    `env:"PORT" envDefault:"8080"`
}

func main() {
    if err := godotenv.Load(); err != nil {
        slog.Debug("no .env file, using real environment")
    }

    fmt.Println("=== with .env ===")
    fmt.Printf("after Load, raw os.Getenv PORT=%q\n", os.Getenv("PORT"))

    cfg, err := env.ParseAs[Config]()
    fmt.Printf("ParseAs err=%v cfg=%+v\n", err, cfg)
}

ไฟล์ .env ที่วางคู่กันมีแค่สองบรรทัด — APP_NAME=svc-from-dotenv และ PORT=8081 · ผลรัน:

=== with .env ===
after Load, raw os.Getenv PORT="8081"
ParseAs err=<nil> cfg={AppName:svc-from-dotenv Port:8081}

แล้วถ้าไม่มีไฟล์ .env เลย Load() คืน error หน้าตายังไง? ผมรันดู:

err (%v)   = open .env: no such file or directory
err type   = *fs.PathError
os.ErrNotExist? = true
program still running, did not panic
exit code: 0

สามชื่อในผลรันข้างบน ถ้ายังไม่เคยเจอ นิยามสั้น ๆ ก่อน:
· *fs.PathError คือชนิดของ error ที่ Go คืนมาเวลาเปิดไฟล์ไม่ได้ (มาจาก package io/fs) — ข้างในเก็บชื่อไฟล์กับสาเหตุไว้ให้
· os.ErrNotExist คือก้อน error สำเร็จรูปของ Go ที่แปลว่า "ไม่มีไฟล์นี้" — มีไว้เอาไปเทียบโดยเฉพาะ
· errors.Is(err, target) คือการถามว่า "error ก้อนนี้เป็นเรื่องเดียวกับ target ไหม" โดยมันจะแกะ error ที่ถูกห่อไว้เป็นชั้น ๆ ให้เองจนเจอ — ไม่ต้องเทียบด้วย == เอง

ในเคสนี้จึงอ่านได้ว่า: error ที่ได้เป็น *fs.PathError ธรรมดา และ errors.Is(err, os.ErrNotExist) คืน true
ข้อมูลนี้มีประโยชน์กว่าที่คิด: ถ้าอยากเขียนให้ดีกว่า slog.Debug เฉย ๆ คุณแยกได้ว่า "ไม่มีไฟล์" (ปกติมากบน production — ข้ามไปเถอะ) กับ "มีไฟล์แต่ไฟล์พัง" (อันนี้ควรตายตั้งแต่ตอน start):

if err := godotenv.Load(); err != nil {
    if errors.Is(err, os.ErrNotExist) {
        slog.Debug("no .env file, using real environment")   // ปกติบน prod
    } else {
        log.Fatalf("broken .env: %v", err)                     // ไฟล์มีอยู่แต่พัง = ปัญหาจริง
    }
}

(ก้อนนี้เป็นเศษโค้ด ไม่ใช่ไฟล์ — เอาไปวางแทนที่ if ใน main() ของไฟล์เต็มข้างบน แล้วเพิ่ม "errors" กับ "log" เข้าไปใน import ด้วย ถึงจะคอมไพล์ผ่าน)

5 · Load() กับ Overload() ต่างกันตรงไหน

$ APP_NAME=from-shell go run . load
$ APP_NAME=from-shell go run . overload

=== Load() with shell env set ===
before: APP_NAME="from-shell"
err=<nil>
after(load): APP_NAME="from-shell"        # .env แพ้ ของเดิมอยู่ต่อ

=== Load() with NO shell env ===
before: APP_NAME=""
err=<nil>
after(load): APP_NAME="from-dotenv"       # ไม่มีของเดิม .env จึงได้เข้า

=== Overload() with shell env set ===
before: APP_NAME="from-shell"
err=<nil>
after(overload): APP_NAME="from-dotenv"   # .env ทับของเดิม

--- run 2: autoload + APP_NAME from shell ---
APP_NAME="from-shell"    # shell ชนะ
PORT="9999"             # PORT ที่ shell ไม่ได้ตั้ง ยังได้จาก .env

$ APP_NAME= go run .        # ตั้งเป็นสตริงว่าง
APP_NAME=""              # .env ไม่เติมให้ ทั้งที่ .env มี APP_NAME=from-dotenv
PORT="9999"

$ go run .                  # ไม่ตั้งเลย
APP_NAME="from-dotenv"    # คราวนี้ .env เติมให้
PORT="9999"

6 · godotenv กับ caarlos0/env ทำหน้าที่ไม่เหมือนกัน

มาถึงหน้าที่สำคัญที่สุดของบทนี้ (สไลด์หน้า 13)
คนที่เพิ่งเห็นสองตัวนี้พร้อมกันมักคิดว่ามันทำอย่างเดียวกัน แล้วสงสัยว่าจะเลือกตัวไหนดี — ซึ่งเป็นคำถามที่ผิดตั้งแต่ต้น เพราะมันอยู่คนละจุดของท่อเดียวกัน:

7 · แผนภาพการทำงานทั้งหมด

สไลด์หน้า 14 รวมทุกอย่างของ Day 9 ไว้ในภาพเดียว ผมวาดตามให้ดูทั้งเส้น — ตัวเลข 1–5 คือลำดับเวลา ทุกขั้นเกิดก่อนที่ server จะรับ request แรก:

สองกล่องทางขวาคือส่วนที่คนอ่านข้ามบ่อยที่สุด แต่มันสำคัญที่สุด:

• กล่องบน — บน production ค่าเข้าที่ขั้น (2) โดยตรง
  ลูกศรชี้เข้า Environment Variables ไม่ได้ชี้เข้า .env แปลว่าขั้น (1) หายไปทั้งขั้นบน production และเส้นทางที่เหลือ (2)→(3)→(4)→(5) เหมือนเดิมทุกประการ
• กล่องล่าง — ถ้าพัง ต้องพังตรงนี้
  ทุกขั้นในภาพนี้เกิดก่อนที่ server จะเปิดรับ request ถ้า config ขาดหรือผิดแม้แต่ตัวเดียว แอปต้อง exit status 1 ทันที ไม่ใช่ start ขึ้นมาแล้วไปพังตอนผู้ใช้จริงยิงเข้ามา (เหตุผลเต็ม ๆ อยู่ใน บทเรียน 44 หัวข้อ 6 ข้อ 5)

เดินทั้งเส้นด้วยของจริง

ผมเอา .env ของสไลด์ (ไฟล์เดียวกับหัวข้อ 2 เป๊ะ ๆ ทั้ง 9 ค่า) มาต่อกับ struct จริง แล้วพิมพ์ผลของขั้น (2) และ (3) ออกมาให้เห็นทั้งคู่
ไฟล์เต็มมีแค่นี้ — ก๊อปทั้งก้อนไปวางเป็น main.go ข้าง ๆ ไฟล์ .env ของหัวข้อ 2 แล้ว go run . ได้เลย:

// main.go — เดินท่อทั้งเส้น: .env → environment → Config struct
package main

import (
    "fmt"
    "os"
    "time"

    "github.com/caarlos0/env/v11"         // ขั้น 2 → 3
    _ "github.com/joho/godotenv/autoload" // ขั้น 1 → 2
)

type Config struct {
    AppName         string        `env:"APP_NAME"`
    AppEnv          string        `env:"APP_ENV"`
    AppPort         int           `env:"APP_PORT" envDefault:"8080"`
    ShutdownTimeout time.Duration `env:"APP_SHUTDOWN_TIMEOUT" envDefault:"10s"`
    LogLevel        string        `env:"LOG_LEVEL" envDefault:"DEBUG"`
    LogFormat       string        `env:"LOG_FORMAT"`
    PostgresDSN     string        `env:"POSTGRES_DSN"`
    MaxOpenConns    int           `env:"POSTGRES_MAX_OPEN_CONNS"`
    ConnMaxLifetime time.Duration `env:"POSTGRES_CONN_MAX_LIFETIME"`
}

func main() {
    fmt.Println("--- STEP 2: os.Getenv (ค่าเป็น string ทั้งหมด) ---")
    for _, k := range []string{
        "APP_ENV", "APP_NAME", "APP_PORT", "APP_SHUTDOWN_TIMEOUT",
        "LOG_FORMAT", "LOG_LEVEL", "POSTGRES_CONN_MAX_LIFETIME",
        "POSTGRES_DSN", "POSTGRES_MAX_OPEN_CONNS",
    } {
        fmt.Printf("%-26s  %q\n", k, os.Getenv(k))
    }

    cfg, err := env.ParseAs[Config]()

    fmt.Println("\n--- STEP 3: env.ParseAs[Config]() ---")
    fmt.Printf("err=%v\n", err)
    fmt.Printf("%-15s %-8T %v\n", "AppPort", cfg.AppPort, cfg.AppPort)
    fmt.Printf("%-15s %-8T %v\n", "ShutdownTimeout", cfg.ShutdownTimeout, cfg.ShutdownTimeout)
    fmt.Printf("%-15s %-8T %v\n", "MaxOpenConns", cfg.MaxOpenConns, cfg.MaxOpenConns)
    fmt.Printf("%-15s %-8T %v\n", "ConnMaxLifetime", cfg.ConnMaxLifetime, cfg.ConnMaxLifetime)
    fmt.Printf("%-15s %-8T %q\n", "AppName", cfg.AppName, cfg.AppName)
    fmt.Printf("%-15s %-8T %q\n", "PostgresDSN", cfg.PostgresDSN, cfg.PostgresDSN)
}

$ go run .          # มีไฟล์ .env อย่างเดียว ไม่ได้ตั้ง env จาก shell เลย

--- STEP 2: os.Getenv (ค่าเป็น string ทั้งหมด) ---
APP_ENV                     "development"
APP_NAME                    "wongnok"
APP_PORT                    "8080"
APP_SHUTDOWN_TIMEOUT        "10s"
LOG_FORMAT                  "text"
LOG_LEVEL                   "DEBUG"
POSTGRES_CONN_MAX_LIFETIME  "30m"
POSTGRES_DSN                "postgres://postgres:secret@localhost:5432/wongnok?sslmode=disable"
POSTGRES_MAX_OPEN_CONNS     "25"

--- STEP 3: env.ParseAs[Config]() ---
err=<nil>
AppPort         int      8080
ShutdownTimeout time.Duration 10s
MaxOpenConns    int      25
ConnMaxLifetime time.Duration 30m0s
AppName         string   "wongnok"
PostgresDSN     string   "postgres://postgres:secret@localhost:5432/wongnok?sslmode=disable"

เทียบสองบล็อกนี้แล้วจะเห็นการแบ่งงานชัดที่สุด
· godotenv ทำให้ STEP 2 มีค่า — ถ้าไม่มีมัน ทั้งเก้าบรรทัดนั้นจะเป็น "" หมด
· caarlos0/env ทำให้ STEP 3 เกิดขึ้น — "25" (ตัวอักษรสองตัว) กลายเป็น int ที่มีค่า 25 · "30m" กลายเป็น time.Duration ที่พิมพ์ออกมาเป็น 30m0s
ไม่มีใครทำงานแทนกันได้ และลำดับสลับกันไม่ได้ — ถ้า ParseAs ทำงานก่อน godotenv มันจะเห็น environment เปล่า ๆ

ทีนี้ลองจำลอง production ตามกล่องขวาบนของแผนภาพ — ลบไฟล์ .env ทิ้ง แล้วส่งค่าทาง env แทน:

$ # (ไม่มีไฟล์ .env อยู่ในโฟลเดอร์แล้ว)
$ APP_NAME=wongnok APP_ENV=production APP_PORT=8080 LOG_LEVEL=INFO LOG_FORMAT=json \
    POSTGRES_DSN='postgres://app:realsecret@db:5432/wongnok?sslmode=require' \
    POSTGRES_MAX_OPEN_CONNS=25 POSTGRES_CONN_MAX_LIFETIME=30m go run .

--- STEP 2: os.Getenv (ค่าเป็น string ทั้งหมด) ---
APP_ENV                     "production"
APP_NAME                    "wongnok"
APP_PORT                    "8080"
APP_SHUTDOWN_TIMEOUT        ""            # ตัวนี้ไม่ได้ตั้ง
LOG_FORMAT                  "json"
LOG_LEVEL                   "INFO"
POSTGRES_CONN_MAX_LIFETIME  "30m"
POSTGRES_DSN                "postgres://app:realsecret@db:5432/wongnok?sslmode=require"
POSTGRES_MAX_OPEN_CONNS     "25"

--- STEP 3: env.ParseAs[Config]() ---
err=<nil>
AppPort         int      8080
ShutdownTimeout time.Duration 10s          # ได้จาก envDefault:"10s"
MaxOpenConns    int      25
ConnMaxLifetime time.Duration 30m0s
AppName         string   "wongnok"
PostgresDSN     string   "postgres://app:realsecret@db:5432/wongnok?sslmode=require"
exit=0

โค้ดไม่ได้แก้แม้แต่บรรทัดเดียว · import _ autoload ยังอยู่ในโปรแกรม · ไม่มีไฟล์ .env · ไม่มี error · แอปได้ config ครบ
นี่คือความหมายของช่อง "ถ้าใช้ผิดที่ → ใส่บน prod = ไม่เกิดอะไร (ไม่มีไฟล์)" ในตารางหัวข้อ 6
สังเกต APP_SHUTDOWN_TIMEOUT ด้วย: env เป็น "" แต่ struct ได้ 10s เพราะ envDefault เข้ามาเติม — คนละกลไกกับ godotenv คนละขั้นตอนกันเลย

8 · ราคาของ autoload ที่สไลด์ยังไม่ได้บอก

สไลด์เขียนว่าวิธีที่ 1 คือแบบที่ "เด็คนี้ใช้" — ซึ่งใช้ได้จริงและสั้นที่สุด
แต่มันมีข้อแลกเปลี่ยนที่ต้องรู้ก่อนใช้ และผมพิสูจน์ให้ดูด้วยไฟล์ .env ตัวเดิมของสไลด์

# .env — วางที่ root ของโปรเจกต์
APP_NAME=wongnok
APP_ENV=development
APP_PORT=8080
APP_SHUTDOWN_TIMEOUT=10s

LOG_LEVEL DEBUG          ← บรรทัดที่ 7 ลืม = (ที่ถูกคือ LOG_LEVEL=DEBUG)
LOG_FORMAT=text

POSTGRES_DSN=postgres://postgres:secret@localhost:5432/wongnok?sslmode=disable
POSTGRES_MAX_OPEN_CONNS=25
POSTGRES_CONN_MAX_LIFETIME=30m

$ go run .

--- STEP 2: os.Getenv (ค่าเป็น string ทั้งหมด) ---
APP_ENV                     ""
APP_NAME                    ""
APP_PORT                    ""
APP_SHUTDOWN_TIMEOUT        ""
LOG_FORMAT                  ""
LOG_LEVEL                   ""
POSTGRES_CONN_MAX_LIFETIME  ""
POSTGRES_DSN                ""
POSTGRES_MAX_OPEN_CONNS     ""

--- STEP 3: env.ParseAs[Config]() ---
err=<nil>
AppPort         int      8080
ShutdownTimeout time.Duration 10s
MaxOpenConns    int      0
ConnMaxLifetime time.Duration 0s
AppName         string   ""
PostgresDSN     string   ""
exit=0

ผมทดสอบรูปแบบบรรทัดพังอีกสองแบบ ได้อาการเดียวกันทั้งหมด:

# bad1.env — GOOD=1 / this line has no equals sign / AFTER=2
err  = unexpected character "\n" in variable name near "this line has no equals sign\nAFTER=2\n"
GOOD after Load  = ""
AFTER after Load = ""

# bad3.env — GOOD=1 / UNCLOSED="oops / AFTER=2   (quote ไม่ปิด)
err  = unterminated quoted value "oops
GOOD after Load  = ""
AFTER after Load = ""

# bad2.env — 123INVALID=x   (ชื่อขึ้นต้นด้วยตัวเลข)
err  = <nil>
123INVALID => "x"

# bad4.env — =novalue   (ไม่มีชื่อ key เลย)
err  = <nil>
           => "novalue"        # key เป็นสตริงว่าง
GOOD after Load = "1"

9 · กับดักในไฟล์ .env ที่เจอตอนใส่ค่าจริง

ไฟล์ตัวอย่างในสไลด์เป็นค่าง่าย ๆ ทั้งหมด แต่ของจริงคุณจะต้องใส่รหัสผ่าน และรหัสผ่านคือที่ที่กับดักอยู่ ผมรันทดสอบมาให้ครบ

9.1 · เครื่องหมาย $ ในรหัสผ่าน — ค่าหายได้จริง

godotenv ทำ variable expansion ให้ด้วย — คือถ้าเจอ $SOMETHING ในค่า มันจะแทนที่ด้วยค่าของตัวแปรชื่อนั้น เหมือนที่ shell ทำ
ฟีเจอร์นี้มีประโยชน์ (เช่น DSN="postgres://$DB_USER@localhost/db") แต่มันทำงานกับรหัสผ่านที่มี $ ด้วย ผมทดสอบสามแบบ:

# .env
A_lower=secret$ssw0rd
B_UPPER=secret$SSW0RD
C_squote='secret$SSW0RD'

$ go run .           # อ่านด้วย godotenv.Read() แล้วพิมพ์ด้วย %q
err=<nil>
A_lower        => "secret$ssw0rd"
B_UPPER        => "secret"
C_squote       => "secret$SSW0RD"

expandVarRegex = regexp.MustCompile(`(\\)?(\$)(\()?\{?([A-Z0-9_]+)?\}?`)

9.2 · เครื่องหมาย # ในค่า — ตัดตอนได้ ถ้ามีช่องว่างนำหน้า

TOK_NOSPACE=abc#123        => "abc#123"       # ติดกัน — ปลอดภัย
TOK_SPACE=abc #123         => "abc"           # มีช่องว่างก่อน # → โดนตัดเป็น comment
TOK_SPACE_Q="abc #123"     => "abc #123"     # ใส่ quote แล้วรอด

กฎคือ # ที่มีช่องว่างนำหน้าจะกลายเป็น comment ท้ายบรรทัด
ซึ่งเป็นกฎที่คุณจะไม่นึกถึงเลยตอนก๊อป API token มาวาง — ถ้าโชคร้ายมันมี " #" อยู่กลางค่า ค่าจะถูกตัดทิ้งครึ่งหลังแบบเงียบ ๆ

9.3 · escape ทำงานแค่ \n กับ \r

MULTILINE="line1
line2
line3"                      # ขึ้นบรรทัดใหม่จริงใน double quote — ใช้ได้
    bytes: 6c 69 6e 65 31 0a 6c 69 6e 65 32 0a 6c 69 6e 65 33
                             ↑ 0a = newline จริง

ESCAPED="tab\there"         # หวังว่า \t จะเป็น tab
    bytes: 74 61 62 74 68 65 72 65
                    ↑ 74 = ตัวอักษร 't' ธรรมดา ไม่ใช่ 09 (tab)

ผมยืนยันจากซอร์ส parser.go ฟังก์ชัน expandEscapes — switch ข้างในรู้จักแค่ case "n" กับ case "r" · ที่เหลือ regex \\([^$]) ตัด backslash ทิ้งเฉย ๆ เหลือแต่ตัวอักษรที่ตามมา

9.4 · รูปแบบอื่นที่รองรับ (รันยืนยันแล้ว)

10 · ห้าม commit .env ขึ้น Git

ข้อสุดท้ายของสไลด์หน้า 11 ข้อนี้ไม่ใช่พฤติกรรมของโค้ด — เป็นธรรมเนียมปฏิบัติ แต่เป็นข้อที่แพงที่สุดถ้าพลาด เพราะดูบรรทัดนี้ในไฟล์ตัวอย่างของสไลด์:

POSTGRES_DSN=postgres://postgres:secret@localhost:5432/wongnok?sslmode=disable

คำว่า secret ตรงนั้นคือรหัสผ่านฐานข้อมูล — ถ้าไฟล์นี้เข้า Git มันจะอยู่ใน ประวัติ repo ถาวร ลบทีหลังไม่ช่วย (เหตุผลเต็มอยู่ใน บทเรียน 44 หัวข้อ 1)
วิธีกันมีบรรทัดเดียว ผมรันให้ดูของจริงในโฟลเดอร์ทดสอบ:

$ /usr/bin/git status --porcelain      # ยังไม่มี .gitignore
?? .env
?? .env.example

$ printf '.env\n' > .gitignore
$ /usr/bin/git status --porcelain
?? .env.example
?? .gitignore                          # .env หายไปจากรายการแล้ว

ถ้าอยากเช็คให้แน่ใจว่ากฎไหนเป็นตัวกัน ใช้ git check-ignore -v:

$ git check-ignore -v .env
.gitignore:1:.env	.env          # กฎบรรทัดที่ 1 ของ .gitignore เป็นตัวกัน
exit=0                                 # exit 0 = ถูก ignore

$ git check-ignore -v .env.example
exit=1                                 # exit 1 = ไม่ถูก ignore (ถูกต้องแล้ว)

# .env.example — commit ตัวนี้ขึ้น Git ได้
APP_NAME=wongnok
APP_ENV=development
APP_PORT=8080
APP_SHUTDOWN_TIMEOUT=10s
LOG_LEVEL=DEBUG
LOG_FORMAT=text
POSTGRES_DSN=postgres://postgres:CHANGE_ME@localhost:5432/wongnok?sslmode=disable
POSTGRES_MAX_OPEN_CONNS=25
POSTGRES_CONN_MAX_LIFETIME=30m

11 · สรุปห้าบรรทัด

--- STEP 3: env.ParseAs[Config]() ---
err=<nil>
AppPort         int      8080         // จาก envDefault
ShutdownTimeout time.Duration 10s     // จาก envDefault
MaxOpenConns    int      0
ConnMaxLifetime time.Duration 0s
AppName         string   ""
PostgresDSN     string   ""
exit=0

ทดสอบความเข้าใจ

--- STEP 3: env.ParseAs[Config]() ---
err=<nil>
AppPort         int      8080
ShutdownTimeout time.Duration 10s
MaxOpenConns    int      0
ConnMaxLifetime time.Duration 0s
AppName         string   ""
PostgresDSN     string   ""

อ้างอิง

• github.com/joho/godotenv — อ่าน README ส่วน "Usage" แล้วเทียบกับหัวข้อ 4 · ที่น่าอ่านกว่าคือไฟล์ autoload/autoload.go ที่มี 15 บรรทัดทั้ง package
• pkg.go.dev — godotenv.Load · Overload · Read — อ่านประโยค "WILL NOT OVERRIDE" ในหน้า Load ซึ่งเป็นที่มาของหัวข้อ 5 ทั้งหมด · Read คืน map โดยไม่แตะ environment เหมาะกับเวลาอยาก debug ว่าไฟล์ถูก parse เป็นอะไร
• github.com/caarlos0/env — ตัวที่ทำขั้น 2 → 3 ของแผนภาพ · รายละเอียดเต็มอยู่ใน บทเรียน 45
• The Twelve-Factor App — III. Config — ต้นทางของประโยค "config ต้องอยู่ใน environment" · สังเกตว่าเอกสารนี้ไม่ได้พูดถึงไฟล์ .env เลย ซึ่งตรงกับที่สไลด์บอกว่ามันเป็นแค่ข้อตกลงของเครื่องมือ
• pkg.go.dev — os.Setenv — สิ่งที่ godotenv เรียกให้เราจริง ๆ ข้างใน · อ่านเพื่อเข้าใจว่าค่าที่ตั้งมีผลกับ process ตัวเองและลูกที่เกิดทีหลังเท่านั้น
• git — gitignore · git-check-ignore — อ่านส่วน exit code ของ check-ignore: 0 = ถูก ignore · 1 = ไม่ถูก ignore ซึ่งเป็นผลที่ใช้ในหัวข้อ 10
• บทเรียน 44 — Configuration & Environment Variables — ปัญหาที่ทั้ง Day 9 เกิดมาแก้ · บทเรียน 45 · บทเรียน 47 · บทเรียน 48