Go Modules

Definisi

Go Modules menggunakan semantic import versioning: untuk major version ≥ 2, import path harus menyertakan /v2, /v3, dst (github.com/x/lib/v3). replace directive di go.mod memetakan modul ke path/versi lain (lokal atau fork) tanpa mengubah kode impor.

Kapan dipakai

Pakai /vN saat rilis major version yang breaking. Pakai replace saat debug modul lokal, fork patch, atau vendor sementara. Jangan pakai replace permanen di library publik (pemakai tak bisa override).

Cara kerja

Major version path

go

import "github.com/foo/lib/v3" // wajib /v3 untuk v3+

replace lokal

go

// go.mod
require github.com/foo/lib v1.2.3
replace github.com/foo/lib => ../lib-local

publish major

bash

git tag v3.0.0
go mod tidy

Struktur alur

Catanya implementasi

• /vN hanya untuk major; minor/patch tidak butuh suffix.
• replace dengan => ../lokal hanya untuk dev; jangan commit ke modul yang didistribusikan (atau hapus sebelum release).
• go mod tidy membersihkan require yang tak terpakai.
• Untuk multi-module, go.work lebih tepat daripada replace (lihat file 176).

Kesalahan umum

• Lupa /vN di import: compiling tapi pakai v1; major v2+ wajib suffix.
• Commit replace lokal: break build orang lain; hapus sebelum tag.
• Major tanpa tag: v2.0.0 harus ada tag git.
• replace bentrok workspace: pakai go.work bila multi-modul.

Referensi terkait

• Go Workspace dan Multi-module: go.work, Replace
• Go Error Handling, Packages, Testing, Project Structure
• TypeScript tsconfig Path Aliases dan Project References