شرح قالب .gitignore لـ Go

يتناول Go.gitignore الملفات الثنائية الناتجة عن البناء، ومخرجات الاختبار والتغطية، وملفات مساحة العمل المحلية. ولأن Go ينزّل الاعتماديات إلى ذاكرة الوحدات ($GOPATH/pkg/mod)، لا ينشأ داخل المستودع مجلد ضخم مثل node_modules في Node، والقالب قصير أيضًا.

لا يُتجاهَل go.mod وgo.sum. يسجّل هذان الملفان اعتماديات الوحدة ومجاميعها الاختبارية (checksum)، فيجب إيداعهما.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
*.exe*.exe~*.dll*.so*.dylib	الملفات الثنائية والمكتباتنتائج go build والمكتبات المشتركة المبنية عبر cgo. تُبنى لكل منصة على حدة، لذا توزَّع كمخرجات إصدار لا عبر المستودع.
*.test	ملفات الاختبار الثنائيةملفات اختبار تنفيذية ينشئها go test -c، ويُلحق باسم الحزمة .test.
*.outcoverage.**.coverprofileprofile.cov	التغطية والتوصيفنتائج أوامر مثل go test -coverprofile=coverage.out. إنها قياسات تتغير مع كل تشغيل.
go.workgo.work.sum	مساحة العململفات تُستخدم عند تطوير عدة وحدات معًا محليًا، وتشير إلى مسارات على قرصك. توضح وثائق go help work أيضًا أن وضع go.work تحت إدارة الإصدارات غير مستحسن عمومًا.
.env	متغيرات البيئةملف يحوي الإعدادات المحلية والقيم السرية. أودِع ملف المثال باسم آخر (مثل .env.example).

ملاحظات عملية

• على Linux وmacOS، ينشئ go build ملفًا تنفيذيًا بلا امتداد (باسم الوحدة). لا يحجبه القالب، لذا أضف قاعدة بنفسك مثل /myapp أو /bin/.
• لا يُتجاهَل vendor/. بعض الفرق تضع الاعتماديات في المستودع عبر go mod vendor، فقرر حسب سياسة فريقك.
• يتجاهل *.out كل ملف ينتهي اسمه بـ .out، فإن كنت تستخدم هذا الامتداد لملفات القيم المتوقعة في الاختبارات فأضف استثناءً مثل !testdata/**/*.out.
• إن كنت تستخدم GoLand فاختر معه قالب JetBrains.

القالب الأصلي

# If you prefer the allow list template instead of the deny list, see community template:# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore## Binaries for programs and plugins*.exe*.exe~*.dll*.so*.dylib# Test binary, built with `go test -c`*.test# Code coverage profiles and other test artifacts*.outcoverage.**.coverprofileprofile.cov# Dependency directories (remove the comment below to include it)# vendor/# Go workspace filego.workgo.work.sum# env file.env# Editor/IDE# .idea/# .vscode/

قوالب تُستخدم معه

شروح قوالب أخرى