go run مقابل go build مقابل go install: ترجمة Go وتشغيلها

يترجم go run البرنامج ويشغّله في خطوة واحدة ولا يحتفظ بملف تنفيذي. ويترجم go build ويترك ملفًا تنفيذيًا في المجلد الحالي. ويترجم go install ويضع الملف التنفيذي في $HOME/go/bin. الثلاثة تترجم إلى شيفرة آلة أصلية؛ ولا يفسّر أي منها شيئًا.

البرنامج التالي هو المستخدم في أمثلة هذه الصفحة. يشغّله المحرّر كما يفعل go run.

package main

import (
	"fmt"
	"os"
	"runtime"
)

// version is overwritten at build time with -ldflags (see below).
var version = "dev"

func main() {
	fmt.Println("version:", version)
	fmt.Println("built for:", runtime.GOOS+"/"+runtime.GOARCH)
	fmt.Println("args:", os.Args[1:])
}

go run

يأخذ go run حزمة (عادة .، أي المجلد الحالي) أو قائمة ملفات .go:

go run .
go run main.go
go run ./cmd/server

كل ما يأتي بعد الحزمة يُمرَّر إلى برنامجك كوسائط:

go run . --port 8080 verbose

version: dev
built for: linux/amd64
args: [--port 8080 verbose]

فضّل go run . على go run main.go. تسمية ملف تترجم ذلك الملف وحده، فبمجرّد أن يصير للحزمة ملف ثانٍ، يُبلَّغ عن الدوال المعرّفة فيه بأنها undefined. صفحة الحزم والاستيراد تشرح هذا الخطأ بالتفصيل.

يشغّل go run أيضًا برنامجًا بعيدًا بإصدار محدّد دون تثبيته، وهذا مفيد لمولّدات الشيفرة:

go run golang.org/x/tools/cmd/stringer@v0.30.0 -type=Color

go build

يترجم go build الحزمة الموجودة في المجلد الحالي. لحزمة main يكتب ملفًا تنفيذيًا؛ ولحزمة مكتبة يترجمها ويبلغ عن الأخطاء ويتخلّص من النتيجة.

go mod init example.com/hello
go build
ls

go.mod  hello  main.go

يتبع اسم الملف التنفيذي هذه القواعد:

شكلان آخران ستستخدمهما باستمرار:

go build ./...      # compile every package in the module
go vet ./...        # static checks, covered below

تعني ./... "هذا المجلد وكل مجلد تحته". وgo build ./... مع عدة حزم main لا يكتب أي ملف تنفيذي؛ إنه فحص سريع لسؤال "هل يُترجم كل شيء".

خيارات بناء مفيدة

الخيار -X هو الطريقة التي تختم بها معظم مشاريع Go رقم الإصدار في الملف التنفيذي. لا يعمل إلا على متغيّرات string على مستوى الحزمة (لا الثوابت):

go build -o app -ldflags "-X main.version=1.4.0" .
./app

version: 1.4.0
built for: linux/amd64
args: []

يسجّل الملف التنفيذي أيضًا إصدارات وحداته، ومنذ Go 1.18 الـ commit الذي بُني منه. يطبعها go version -m ./app، ويستطيع البرنامج قراءتها بـ runtime/debug.ReadBuildInfo.

go install

يبني go install تمامًا مثل go build ثم ينقل الملف التنفيذي إلى $GOBIN، أو إلى $GOPATH/bin عندما لا يكون GOBIN مضبوطًا (افتراضيًا $HOME/go/bin):

go install .
go env GOPATH

أشيع استخدام له هو تثبيت أدوات مكتوبة بـ Go. ومع @version يثبّت برنامجًا دون المساس بـ go.mod:

go install golang.org/x/tools/gopls@latest
go install honnef.co/go/tools/cmd/staticcheck@latest

إذا لم تجد الصدفة أداة بعد ذلك، فإن $HOME/go/bin ليس ضمن PATH. أضف export PATH=$PATH:$(go env GOPATH)/bin إلى ملف إعدادات الصدفة.

الترجمة لمنصّات أخرى بـ GOOS وGOARCH

تستطيع Go البناء لنظام تشغيل أو معالج آخر من أي جهاز، دون أدوات إضافية. اضبط متغيّري بيئة لأمر البناء:

GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 .
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 .
GOOS=darwin GOARCH=arm64 go build -o app-macos .
GOOS=windows GOARCH=amd64 go build -o app.exe .

في PowerShell تُضبط متغيّرات البيئة بطريقة مختلفة:

$env:GOOS = "linux"; $env:GOARCH = "amd64"; go build -o app-linux .

الأزواج الأشيع:

يطبع go tool dist list كل زوج مدعوم (48 في Go 1.24).

الترجمة لمنصّات أخرى بهذه السهولة فقط لشيفرة Go الخالصة. الحزمة التي تستخدم cgo (شيفرة C، مثل بعض مشغّلات SQLite) تحتاج مترجم C للمنصّة الهدف. عند الترجمة لمنصّة أخرى يكون cgo معطّلًا افتراضيًا، وضبط CGO_ENABLED=0 صراحة يعطيك أيضًا ملفًا تنفيذيًا ساكنًا بالكامل لـ Linux، وهو ما تريده في صورة حاوية مصغّرة من نوع scratch أو distroless.

go fmt وgo vet

فحصان ينتميان إلى كل سير عمل، وإلى CI.

يعيد go fmt كتابة الملفات بالأسلوب الرسمي الوحيد: مسافات جدولة، وحقول محاذاة، وتباعد موحّد. وهو غلاف حول gofmt -l -w:

go fmt ./...
gofmt -l .     # list files that are not formatted; empty output means clean

يبلغ go vet عن شيفرة تُترجم لكنها خاطئة شبه يقينًا. عدم تطابق تنسيقات Printf هو المثال الكلاسيكي:

package main

import "fmt"

func main() {
	count := 3
	fmt.Printf("%s items\n", count)
}

go vet ./...

# example.com/hello
# [example.com/hello]
./main.go:7:2: fmt.Printf format %s has arg count of wrong type int

يُترجم البرنامج ويطبع %!s(int=3) items، وهذا بالضبط نوع الأخطاء الذي وُجد vet لاكتشافه. من فحوص vet الأخرى: نسخ sync.Mutex بالقيمة، والشيفرة التي لا يمكن الوصول إليها، ووسوم البنى ذات الصيغة الخاطئة، وcontext.CancelFunc لا تُستدعى أبدًا. يشغّل go test جزءًا من هذه الفحوص تلقائيًا؛ أما go build فلا يشغّل أيًا منها.

أوامر go فرعية أخرى

لماذا يكون البناء سريعًا في المرة الثانية

تخزّن Go الحزم المترجمة في ذاكرة البناء المؤقّتة (go env GOCACHE). إعادة البناء تعيد ترجمة الحزم التي تغيّر مصدرها أو اعتمادياتها فقط، فيبدأ go run . على مشروع لم يتغيّر فورًا تقريبًا. إذا تصرّف البناء بغرابة بعد تغيير إصدار Go أو متغيّرات البيئة، يفرّغها go clean -cache؛ ونادرًا ما ستحتاج ذلك.