راهنمای کاربردی Go برای ساختار بسته‌ها، توابع، خطاها، interfaceها و هم‌زمانی. خطا را به‌صورت مقدار برگردانید و بلافاصله پس از فراخوانی بررسی کنید. slice و map را با رفتار اشتراک و مقدار صفرشان بشناسید. interface کوچک را نزدیک مصرف‌کننده تعریف کنید. structها را با دادهٔ لازم بسازید و رفتارهای مرزی را با تست جدول‌محور پوشش دهید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.
قرارداد Go معمولاً نتیجه را همراه error برمی‌گرداند.
func parsePort(raw string) (int, error) { port, err := strconv.Atoi(raw) if err != nil { return 0, fmt.Errorf("parse port: %w", err) } if port < 1 || port > 65535 { return 0, fmt.Errorf("port out of range: %d", port) } return port, nil}slice جدید بسازید تا ورودی تابع ناخواسته تغییر نکند.
func activeNames(users []User) []string { names := make([]string, 0, len(users)) for _, user := range users { if user.Active { names = append(names, user.Name) } } return names}مقدار دوم map lookup مشخص می‌کند کلید وجود دارد یا مقدار صفر است.
value, ok := settings["theme"]if !ok { value = "system"}Go interface را به‌صورت ضمنی با پیاده‌سازی متدها satisfy می‌کند.
type Reader interface { Read([]byte) (int, error)}func readHeader(reader Reader) ([]byte, error) { header := make([]byte, 8) _, err := io.ReadFull(reader, header) return header, err}constructor می‌تواند invariant را بررسی و مقدار معتبر بازگرداند.
type User struct { ID int Email string}func NewUser(id int, email string) (User, error) { if id <= 0 || !strings.Contains(email, "@") { return User{}, errors.New("invalid user") } return User{ID: id, Email: email}, nil}جدول ورودی‌ها یک قرارداد را برای چند حالت با کد تکراری کمتر می‌سنجد.
func TestIsEven(t *testing.T) { tests := []struct { input int want bool }{{2, true}, {3, false}} for _, test := range tests { if got := IsEven(test.input); got != test.want { t.Errorf("IsEven(%d) = %v, want %v", test.input, got, test.want) } }}context را از caller دریافت و به درخواست شبکه منتقل کنید.
func fetch(ctx context.Context, url string) (*http.Response, error) { request, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil) if err != nil { return nil, err } return http.DefaultClient.Do(request)}channel نتیجه را به مصرف‌کننده می‌رساند و با defer بسته می‌شود.
func squares(values []int) <-chan int { output := make(chan int) go func() { defer close(output) for _, value := range values { output <- value * value } }() return output}برای batchهای مستقل، تعداد workerها را محدود و پایان کار را join کنید.
var group sync.WaitGroupfor _, job := range jobs { group.Add(1) go func(job Job) { defer group.Done() process(job) }(job)}group.Wait()بسته اجرایی با package main و تابع func main() آغاز می‌شود.
اعلان کوتاه محلی: name := value؛ از بیرون بسته با حرف بزرگ export می‌شود.
تابع می‌تواند چند مقدار بازگرداند؛ خطا را معمولاً صریح برگردانید.
ساختار داده را با struct و رفتار مشترک را با interface تعریف کنید.
برای مجموعه‌ها slice و map به‌کار ببرید؛ مقدار صفر آن‌ها را بشناسید.
منابعی مانند فایل را با defer Close() ببندید.
هم‌زمانی با goroutine و channel را ساده نگه دارید و مالکیت داده را روشن کنید.
از context.Context برای لغو و timeout درخواست‌های زنجیره‌ای استفاده کنید.
وابستگی‌ها را با Go modules ثبت و go fmt را اجرا کنید.
با go test ./... تست کنید و خطاهای هم‌زمانی را با race detector بسنجید.
خطا را با %w wrap کنید و برای تشخیص نوع یا مقدار از errors.Is و errors.As کمک بگیرید.
برای slice، len و cap را جدا در نظر بگیرید؛ append ممکن است backing array تازه بسازد.