လေ့ကျင့်ခန်း — Git ပြဿနာကို Diagnose လုပ်ခြင်း

နားလည်ထားရမယ့် အချက်

Git က မင်းတောင်းဆိုတဲ့အရာကို ငြင်းပယ်တဲ့အခါ, fix တစ်ခုကို ခန့်မှန်းပြီး ထပ်စမ်းချင်စိတ် ဖြစ်တတ်ပါတယ်။ ဒီအလေ့အထကြောင့် ပြဿနာသေးလေးက ပြဿနာကြီးဖြစ်လာတတ်ပါတယ်။ Git troubleshooting ရဲ့ တကယ့် skill က diagnosis ပါ — တခြားဘာမှ မထိခင် Git က ဘာပြောနေလဲ အတိအကျ ဖတ်ရမှာပါ။

• `git status` — working directory နဲ့ staging area လက်ရှိ ဘယ်လိုပုံစံလဲ။
• `git log --oneline --graph --all` — သိထားတဲ့ branch နဲ့ remote-tracking branch အားလုံးရဲ့ history တကယ့်ပုံစံ။

Git ရဲ့ error နဲ့ status message တွေက အံ့ဩစရာလောက် literal ဖြစ်ပါတယ် — rejected push, merge conflict marker, "detached HEAD" warning တစ်ခုစီက repository ရဲ့ တကယ့် state ကို ညွှန်ပြနေတာပါ၊ မရေရာတဲ့ ညည်းညူချက် မဟုတ်ပါဘူး။ အထက်က command နှစ်ခုက ဘာမှမလုပ်ခင် လိုအပ်တဲ့ မေးခွန်းနှစ်ခုကို ဖြေပေးပါတယ် — ငါဘယ်နေရာမှာရှိလဲ, history က ဘယ်လို ဒီနေရာရောက်လာခဲ့လဲ။

ဒီသင်ခန်းစာက concrete case တစ်ခုကို လေ့လာပါမယ် — local clone မှာ တစ်ခါမှ မမြင်ဖူးတဲ့ commit တွေ remote မှာ ရှိနေလို့ Git က ငြင်းပယ်တဲ့ `git push` — branch တစ်ခုတည်းပေါ်မှာ sync မလုပ်ဘဲ လူနှစ်ယောက် အလုပ်လုပ်နေတဲ့ classic symptom ပါ။ GitHub ရဲ့ ကိုယ်စား local bare repository တစ်ခုနဲ့ rejection ကို အစစ်အမှန် ပြန်ဖန်တီးရပါမယ်။

Diverge လုပ်နေတဲ့ branch, detached HEAD, (သို့) မှားနေတဲ့ staged file တစ်ခုစီအတွက် ဖြေရှင်းတဲ့ command တွေက အမှန်တကယ် ကွဲပြားပါတယ်။ Diagnostic အလေ့အထ — message ဖတ်ပါ, status စစ်ပါ, history စစ်ပါ, ပြီးမှ လုပ်ဆောင်ပါ — ဆိုတာချည်းက Git ပြဿနာတိုင်းကို ကူညီပေးနိုင်တဲ့ တစ်ခုတည်းသော skill ပါ။

PUSH REJECTED: LOCAL MAIN VS ORIGIN/MAIN
----------------------------------------
origin/main (bare repo)          your local "you" clone
------------------------         ------------------------
24e9b92 Initial commit           24e9b92 Initial commit
3e8f241 Add Contributing         44aff82 Add Installation
  ^ teammate pushed this           ^ you committed this,
    -- you don't have it            origin doesn't have it
       locally yet

                git push origin main
                        |
                        v
        ! [rejected]   main -> main (fetch first)
   "remote contains work that you do not have locally"

AFTER: git fetch reveals the divergence, then merge + push
  origin/main == local main == one new merge commit

လက်တွေ့ scenario နဲ့ ချိတ်ကြည့်မယ်

ဒါကို အစစ်အမှန်ဖြစ်အောင်, GitHub remote ရဲ့ ကိုယ်စား local bare repository တစ်ခုတည်းသုံးပြီး လူနှစ်ယောက်ပါတဲ့ team ကလေးတစ်ခု တည်ဆောက်ပါမယ်။ Bare repo (`git init --bare`) မှာ working directory မရှိပါဘူး — GitHub ပေါ်ကရော `origin` လိုပဲ push/pull လုပ်ဖို့ရည်ရွယ်ချက်နဲ့ရှိတာပါ။

ကိုယ့် clone ကို ပြန်လာပြီး, fetch မလုပ်ဘဲ ကိုယ့် change ကို commit လုပ်ပြီး `git push` run ပါ။ Git က ငြင်းပယ်ပါလိမ့်မယ် — bug မဟုတ်ပါဘူး, Git က shared history ကို တိတ်တဆိတ် overwrite မဖြစ်အောင် ကာကွယ်နေတာပါ။

ပြသထားတဲ့ rejection text အတိအကျကို ဖတ်ပြီး, `git status` နဲ့ `git fetch` ကို သုံးကာ ကိုယ့် branch နဲ့ `origin/main` ဘယ်လိုကွဲထွက်နေလဲ ဆုံးဖြတ်ခင် တိတိကျကျ ကြည့်ပါ။ အဆုံးမှာ တကယ့် push rejection တစ်ခု ဖြစ်ပျက်တာကို ကြည့်ရမယ်, team အစစ်မှာလုပ်သလိုပဲ ဖြေရှင်းပေးရပါမယ်။

• Rejected push ဆိုတာ Git က shared history ကို ကာကွယ်နေတာပါ၊ force ဖြတ်ရမယ့် error မဟုတ်ပါဘူး။
• `git status` က နောက်ဆုံး fetch ကို ရေရာတာပါ၊ remote ရဲ့ live state မဟုတ်ပါဘူး — အမှန်ကို ကြည့်ဖို့ `git fetch` run ပါ။
• `git log --oneline --graph --all` က action မယူခင် local နဲ့ remote branch ဘယ်လိုကွဲထွက်နေလဲ အတိအကျ ပြပါတယ်။

အတူတူ စမ်းရေးကြည့်မယ်

# One-time setup
git config --global init.defaultBranch main

# Create a bare repo to stand in for a GitHub remote
git init --bare team-repo.git

# --- You: clone it and push the first commit ---
git clone team-repo.git you
cd you
export GIT_AUTHOR_NAME="Thuta Learner"
export GIT_AUTHOR_EMAIL="learner@example.com"
export GIT_COMMITTER_NAME="Thuta Learner"
export GIT_COMMITTER_EMAIL="learner@example.com"
export GIT_AUTHOR_DATE="2026-01-01T09:00:00"
export GIT_COMMITTER_DATE="2026-01-01T09:00:00"
echo "# Team Project" > README.md
echo "Initial setup." >> README.md
git add README.md
git commit -m "Initial commit: add README"
git push origin main
cd ..

# --- Teammate: clone the SAME bare repo, push a second commit ---
git clone team-repo.git teammate
cd teammate
export GIT_AUTHOR_NAME="Maung Maung"
export GIT_AUTHOR_EMAIL="maungmaung@example.com"
export GIT_COMMITTER_NAME="Maung Maung"
export GIT_COMMITTER_EMAIL="maungmaung@example.com"
export GIT_AUTHOR_DATE="2026-01-01T10:15:00"
export GIT_COMMITTER_DATE="2026-01-01T10:15:00"
echo "" >> README.md
echo "## Contributing" >> README.md
echo "See CONTRIBUTING.md for guidelines." >> README.md
git add README.md
git commit -m "Add Contributing section to README"
git push origin main
cd ..

# --- You again: commit locally WITHOUT fetching first, then push ---
cd you
export GIT_AUTHOR_DATE="2026-01-01T11:00:00"
export GIT_COMMITTER_DATE="2026-01-01T11:00:00"
echo "" >> README.md
echo "## Installation" >> README.md
echo "Run npm install to get started." >> README.md
git add README.md
git commit -m "Add Installation section to README"
git push origin main

# --- Diagnose: what does Git actually tell us? ---
git status
git log --oneline
git fetch origin
git log --oneline --graph --all
git status

နောက်ဆုံး push ကို ငြင်းပယ်ခံရပါတယ် —

To .../team-repo.git
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to '.../team-repo.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.

Fetch မလုပ်ခင်, `git status` က —

On branch main
Your branch is ahead of 'origin/main' by 1 commit.

ဒါက technically မှန်ပေမယ့် လှည့်ဖြားတတ်ပါတယ် — အခုလက်ရှိ remote ကို မဟုတ်ဘဲ နောက်ဆုံး fetch ကို ရေရာနေတာပါ။ `git fetch origin` ပြီးနောက်, `git log --oneline --graph --all` က "Initial commit" ancestor တူတူကနေ ခွဲထွက်သွားတဲ့ branch နှစ်ခုကို ပြပြီး, `git status` က တကယ့်ပုံစံကို ယခု ပြောပါတယ် —

On branch main
Your branch and 'origin/main' have diverged,
and have 1 and 1 different commits each, respectively.

Pro Git -- Working with Remotes — Git & GitHub