آموزش گیت - برگه مرجع

برای اینکه هنگام کار با Git بتوانیم مهم‌ترین و پرکاربردترین دستورات را راحت‌تر پیدا کنیم و به کار ببریم، راهنمای سریع (cheat sheet) زیر یک مرجع مفید است.

راه‌اندازی

تنظیم داده‌های کاربر که در تمام مخازن محلی (local repositories) استفاده می‌شود.

git config --global user.name [firstname lastname]

نامی را انتخاب کنید که هنگام بررسی تاریخچه نسخه‌ها، هویت ما را به‌وضوح برای انتساب تغییرات مشخص کند.

git config --global user.email [valid-email]

آدرس ایمیلی را مشخص کنید که به هر نشانگر تاریخی متصل خواهد شد.

git config --global color.ui auto

برای بررسی راحت‌تر، Git را طوری پیکربندی کنید که دستورات را در خط فرمان به‌صورت خودکار رنگی کند.

راه‌اندازی و مقداردهی اولیه

تنظیم جزئیات کاربر، مقداردهی اولیه مخازن و کلون کردن (شبیه‌سازی) مخازن.

git init

راه‌اندازی یک دایرکتوری موجود به‌عنوان یک مخزن برای Git.

git clone [url]

با استفاده از یک URL، مخزن کامل را از یک مکان میزبانی‌شده بازیابی کنید.

آماده‌سازی (Stage) و ثبت وضعیت (Snapshot)

استفاده از ناحیه آماده‌سازی (staging area) و ثبت وضعیت‌ها در Git.

git status

فایل‌های به‌روزشده در دایرکتوری کاری ما را که آماده کامیت (commit) بعدی هستند، نمایش می‌دهد.

git add [file]

نسخه فعلی فایل را به کامیت آینده ما (ناحیه stage) اضافه می‌کند.

git reset [file]

فایل را از حالت stage خارج می‌کند در حالی که تغییرات دایرکتوری کاری را حفظ می‌کند.

git diff

تغییراتی را که در حالت stage قرار گرفته‌اند مشاهده کنید.

git diff --staged

تفاوت‌های مواردی که در حالت stage قرار گرفته‌اند اما هنوز کامیت نشده‌اند.

git commit -m [descriptive message]

یک اسنپ‌شات کامیت جدید با محتوای stage شده ما ایجاد می‌کند.

شاخه‌سازی (Branch) و ادغام (Merge)

جداسازی کار در شاخه‌ها، تغییر محیط کاری و یکپارچه‌سازی تغییرات.

git branch

شاخه‌های ما را فهرست می‌کند؛ شاخه‌ای که در حال حاضر فعال است، یک علامت * در کنار خود خواهد داشت.

git branch [branch-name]

یک شاخه جدید پس از آخرین کامیت ایجاد می‌کند.

git checkout

به شاخه دیگری جابه‌جا می‌شود و آن را در دایرکتوری کاری ما بارگذاری (check out) می‌کند.

git merge [branch]

تاریخچه شاخه مشخص‌شده را با شاخه فعلی ادغام می‌کند.

git log

تاریخچه تمام کامیت‌های انجام‌شده در شاخه فعلی را نشان می‌دهد.

بازبینی و مقایسه

بررسی گزارش‌ها (logs)، تفاوت‌ها (diffs) و داده‌های اشیاء

git log

تاریخچه تمام کامیت‌های انجام‌شده در شاخه فعلی را نشان می‌دهد.

git log branchB..branchA

کامیت‌های شاخه A را که در شاخه B وجود ندارند نمایش می‌دهد.

git log --follow [file]

تغییرات ایجادشده توسط کامیت‌ها در فایل را، حتی پس از تغییر نام، نمایش می‌دهد.

git diff branchB...branchA

تفاوت‌های بین آنچه در شاخه A است و آنچه در شاخه B نیست را نمایش می‌دهد.

git show [SHA]

هر شیئی در Git را در قالب قابل خواندن برای انسان نمایش می‌دهد.

ردیابی تغییرات مسیر

نسخه‌بندی حذف فایل‌ها و اصلاحات مسیر

git rm [file]

فایل را از پروژه حذف کرده و آن را برای کامیت آماده می‌کند.

git mv [existing-path] [new-path]

مسیر یک فایل موجود را تغییر داده و این جابه‌جایی را در حالت stage قرار می‌دهد.

git log --stat -M

تمام گزارش‌های کامیت را همراه با نشان دادن هر مسیری که جابه‌جا شده است، نمایش می‌دهد.

نادیده گرفتن الگوها

جلوگیری از قرار گرفتن تصادفی فایل‌ها در حالت stage یا کامیت شدن آن‌ها.

logs/
*.notes
pattern*/

الگوهای مورد نظر را در فایلی با پسوند .gitignore ذخیره کنید و از الگوهای عام (wildcard globs) یا تطابق‌های مستقیم رشته استفاده کنید.

git config --global core.excludesfile [file]

نادیده گرفتن الگو برای تمام مخازن محلی در سراسر سیستم.

اشتراک‌گذاری و به‌روزرسانی

بازیابی به‌روزرسانی‌ها از یک مخزن دیگر و به‌روزرسانی مخزن محلی.

git remote add [alias] [url]

یک نام مستعار (alias) برای یک آدرس git ایجاد می‌کند.

git fetch [alias]

تمام شاخه‌های موجود در آن مخزن راه دور (remote) Git را دریافت می‌کند.

git merge [alias]/[branch]

به‌منظور به‌روزرسانی شاخه ما، یک شاخه راه دور را در آن ادغام می‌کند.

git push [alias] [branch]

کامیت‌ها را از شاخه محلی به شاخه مخزن راه دور منتقل می‌کند.

git pull

کامیت‌ها را از شاخه راه دور ردیابی‌شده دریافت کرده و آن‌ها را ادغام می‌کند.

بازنویسی تاریخچه

تغییر کامیت‌ها، بازنویسی شاخه‌ها و حذف تاریخچه

git rebase [branch]

هرگونه کامیت شاخه فعلی را پیش از شاخه تعیین‌شده اعمال می‌کند.

git reset --hard [commit]

هرگونه کامیت شاخه فعلی را پیش از کامیت تعیین‌شده اعمال می‌کند.

کامیت‌های موقت

ذخیره موقت فایل‌های ردیابی‌شده‌ای که به‌روزرسانی شده‌اند به‌منظور جابه‌جایی بین شاخه‌ها.

git stash

ذخیره تغییرات اصلاح‌شده و stage شده

git stash list

فهرست کردن تغییرات به ترتیب پشته (stack-order) برای فایل‌های ذخیره‌شده

git stash pop

کار کردن از بالاترین مورد پشته stash هنگام نوشتن

git stash drop

حذف اصلاحات از بالاترین مورد پشته stash.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.