YouMind
登入

圖解 Git:高中生初學者指南

@dan_pro_man
日語2026年10月10日
106K
205
23
0
674

TL;DR

一份適合初學者的指南,詳細說明基本的 GitHub 工作流程,包括建立儲存庫、提交 Pull Request、檢視差異(diffs)以及還原變更,特別針對使用 AI 程式碼助理的使用者進行調整。

你是不是用著 GitHub,卻其實不太清楚自己在做什麼?

盲目操作只會把東西搞壞。

GitHub 上只有三個綠色按鈕。

按下它們之前,你只需要看一個地方。

這篇文章會用紅框標示出 GitHub 畫面上所有「該看」和「該按」的地方。

連線、提交、檢查 diff、合併、還原。

我們會用 10 張實際截圖,帶你跑完這整個流程。

打字交給 AI。

你只負責看和按。

遇到難懂的術語,我會順手用最簡單的方式解釋。

※ 本文中的 GitHub 畫面與規格以 2026 年 10 月的版本為準。畫面可能會隨時間改變。

第 1 章:連接 GitHub|建立 Repository 並上傳本機紀錄

GitHub 的介面是英文的。

但要按的地方是固定的。

畫面上的紅框會告訴你該看哪裡、該按哪裡。

這一章裡,你只需要按一個綠色按鈕。

首先,建立一個 repository。

repository 就像一個置物櫃,用來在線上存放你的 Git 紀錄。

關於這個置物櫃裡裝了什麼,以及四個關鍵術語,我在上一篇文章中已經說明過了。

【附圖解】連國中生都看得懂的 Git 教學

https://x.com/dan_pro_man/status/2107224533099069671?s=20

就算你還沒看過那篇,光靠這篇文章也能跑完整個流程。

登入 GitHub,點選右上角的「+」圖示,選擇「New repository」。

直接開啟 https://github.com/new 也會進入同一個畫面。

だん|AI×クラウドエンジニア - inline image

你唯一需要填的就是名稱。

在「Repository name」輸入英數字組成的名稱。

例如「git-practice」就可以。

在「Choose visibility」下方選擇「Private」。

這代表不公開。

「Add README」的開關先保持關閉。

如果你已經有本機紀錄,建立一個空的 repository 再連線會比較輕鬆。

按下最下方的綠色「Create repository」按鈕。

按下後出現的畫面,是這一章最重要的部分。

だん|AI×クラウドエンジニア - inline image

靠近底部的地方有一個標題:「…or push an existing repository from the command line」。

下面的三行指令,就是我們今天會用到的。

上面的七行是給還沒有本機紀錄的人看的,你可以直接跳過。

這三行的意思如下:

第 1 行:告訴你的本機紀錄,這個置物櫃的地址在哪裡。

第 2 行:將主分支的名稱統一為「main」。

第 3 行:把 main 分支存進置物櫃。

從這個畫面複製地址(紅框處),用一行文字傳給 AI。

text
1把這個資料夾裡的紀錄上傳到 https://github.com/account-name/git-practice

Claude Code 會自己打出這三行指令。

Claude Code 是一個能根據指令在你電腦上執行任務的 AI。

在我的操作手冊裡,我規定它在 push 之前必須先跟我確認。

push 就是把本機紀錄存進置物櫃的操作。

所以它會在這裡先停下來。

回答「Yes」,然後重新整理瀏覽器畫面。

だん|AI×クラウドエンジニア - inline image

原本顯示三行指令的地方,現在會列出你的本機檔案。旁邊則是 commit message。

這就是「連線成功」的證明。

這裡有一件事希望你注意。

檔案列表上方的「main」字樣。

它代表你目前正在查看置物櫃裡的哪一個書籤。

書籤就是 branch(分支)。

它標記了你正在哪一欄堆疊紀錄。

接下來請不要直接去動這個「main」。

一開始我也沒太在意這件事。

結果直接在 main 上作業,浪費了很多時間才找到要退回哪裡。

連線失敗時,通常問題都出在地址。

結尾的「.git」漏掉了。

帳號名稱拼錯了。

如果看到「not found」,請回到圖②重新複製一次地址。

到這裡,你的本機紀錄就已經連上 GitHub 了。接下來是透過 Pull Request 進行合併的日常流程。

**

第 2 章:透過 Pull Request 合併|提交 AI 的成果、檢查 diff,然後按下按鈕

從這裡開始進入日常流程。

Pull Request 就是一份寫著「請幫我合併」的提交申請。

這一章裡,你需要按三個綠色按鈕。

打字交給 AI。

你只負責看和按。

だん|AI×クラウドエンジニア - inline image

首先,傳一行指令給 AI。

text
1建立一個新分支,在 README 加上 3 行使用說明,commit 後上傳到 GitHub

README 是你第一個用來撰寫 repository 說明的檔案。

Claude Code 會建立分支。

修改檔案並 commit。

最後,它會在 push 之前停下來詢問你。

回答「Yes」,然後用瀏覽器打開置物櫃。

だん|AI×クラウドエンジニア - inline image

頂部會出現一條黃色橫幅。

它在通知你:「我剛剛把這個分支存進去了」。

按下右邊的綠色按鈕「Compare & pull request」。

這就是「提交」。

就像把草稿本交給老師一樣。

光是提交,並不會把任何內容寫進正式版。

必須經過審查才會真正合併。

だん|AI×クラウドエンジニア - inline image

提交畫面上有三個地方要看。

第一:最上方的箭頭。

「base: main」與「compare: work-branch」

這表示要從哪裡合併到哪裡。

只要確認左邊是 main 就好。

第二:「Add a title」裡的標題。

如果是 AI 產生的,裡面會包含變更摘要。

如果是手動提交,系統會預先填入 commit message。

手動提交時,用一行話寫清楚「做了什麼」。

第三:綠色的「Create pull request」按鈕。

按下去就代表受理這份提交。

提交之後,就需要人類接手了。

畫面頂部會出現四個分頁。

只看最右邊的「Files changed」分頁。

意思是已變更的檔案。

だん|AI×クラウドエンジニア - inline image

綠色的行是新增的內容。

紅色的行是刪除的內容。

這就是 diff。

如果你要求的那 3 行是綠色的,就算過關。

範例畫面中因為連同標題和空行一起加上了,所以總共有 6 行綠色。

如果出現你沒要求的紅色行,就不要合併。

範例畫面中有 1 行紅色。

「Items placed」裡少了一行備註。

如果你沒有要求這麼做,就在這裡停下來。

問 AI:「你為什麼刪掉這行紅色的?」

這是把工作交給 AI 時最關鍵的 30 秒。

以前光是看到審查通知就覺得壓力山大,我常常看都不看就直接按下去。

現在,我會先數紅色行有幾行。

只要有一行不是我要求的,我就會停下來。

如果 diff 沒問題,就回到「Conversation」分頁。

靠近底部有一個綠色的「Merge pull request」按鈕。

如果上方顯示「No conflicts with base branch」,就可以直接合併。

だん|AI×クラウドエンジニア - inline image

按下去後會變成「Confirm merge」。

再按一次。

這樣工作分支的紀錄就合併進 main 了。

だん|AI×クラウドエンジニア - inline image

顏色會變成紫色,並顯示「Merged」。

下方會出現一個方塊,寫著「Pull request successfully merged and closed」。

右邊則是「Delete branch」。

放心按下去吧。

消失的只是置物櫃裡工作分支的「書籤」。

既然紀錄已經合併進 main,就不會有任何東西遺失。

最後,更新你的本機環境。

告訴 AI:「切換到 main,並從 GitHub 拉取最新狀態」。

這樣就完成一次循環了。

下一個任務請從新的分支開始。

不要在 main 上直接作業。

到這裡,你已經完成了提交、檢查 diff、合併的流程。接下來要介紹 Revert,也就是合併後用來反悔的按鈕。

**

第 3 章:Revert|一鍵撤銷合併後的錯誤

有時候合併之後才發現有錯。

在 Git 裡,你是「撤銷」已儲存的紀錄,而不是刪除它們。

GitHub 畫面上就有對應的按鈕。

叫做「Revert」。

重新打開你剛剛合併的那個 Pull Request。

裡面會有一行寫著「merged commit … into main」。

那一行的最右邊就是「Revert」。

だん|AI×クラウドエンジニア - inline image

按下去會發生什麼事?

紀錄並不會被刪除。

而是會建立一個帶有相反變更的新 Pull Request。

根據官方文件,當你合併這個新的 Pull Request 時,才算真正完成還原。

所以,revert 走的也是第 2 章的同一套流程。

檢查 diff,然後按綠色按鈕。

不是刪除,而是新增一筆「已還原」的紀錄。

如果要叫 AI 處理,就說:「撤銷我剛剛合併的 Pull Request」。

Claude Code 會用 git revert 做一樣的事。

還有一個畫面你也可能會遇到。

だん|AI×クラウドエンジニア - inline image

「This branch has conflicts that must be resolved」。

這就是衝突(conflict)。

當 main 和工作分支對同一行做了不同修改時就會發生。

綠色按鈕會變灰,無法點擊。

不要試圖在畫面上解決它,直接傳一行指令給 AI。

text
1拉取 main,並把衝突部分的兩個版本都秀給我看

由你決定要保留哪一個。

等 AI 修正並重新上傳後,綠色按鈕就會恢復。

衝突不是失敗。

它只是揭露了「同一行被改了兩次」這個事實。

最後,有一件畫面上看不到的事。

金鑰。

含有密碼或 API key 的檔案,絕對不能上傳到 GitHub。

就算你用了 Revert,一旦金鑰被上傳,就視為已洩漏,必須重新產生。

上傳前,先告訴 AI:「把 .env 排除在紀錄之外」。

在我自己的工作環境裡,我會把 AWS 設定寫在文字檔中,並遵循同樣的流程。

沒檢查 diff 就合併的設定,會直接跑在正式環境上。

因此,按下按鈕前那關鍵的 30 秒,我絕不交給 AI。

畫面上的所有按鈕都由人類來按。

即使我不斷擴大 AI 的工作範圍,這條規則也從未改變。

到這裡,連線、提交、合併、還原的完整流程就全部結束了。

最後,我準備了可以直接使用的素材。

我把在 GitHub 畫面上完成一次循環的步驟都寫出來了。

也將本文中的畫面與 prompt 整理成可直接套用的格式。

  • GitHub 畫面對照海報(9 張畫面、69 個術語)
  • AI 搞砸時的復原地圖(6 種情境)
  • 完成一次循環的 7 組 Prompt
  • 合併前檢查清單(8 個項目)

以上整合成一本 15 頁的 PDF 小冊子提供。

只要有這些,你今天就能開始跑循環。

想領取的話,只要加入下方的 Open Chat。

加入後依照指示傳送「Submit」,就會自動發送給你。

https://line.me/ti/g2/pEpZQdEyn1BM5Zi2wqLBT2rZYpC0ZaOncIWTag

だん|AI×クラウドエンジニア - inline image

總結:今天就先跑完一次循環

不要把 AI 的成果直接放進 main。

從工作分支提交、檢查 diff,然後按下綠色按鈕。

一次循環裡總共要按三個綠色按鈕。

我第一次親手按下 Revert 的那天,才明白紀錄是不會被刪除的。

從那之後,我就不怕動手嘗試了。

你不需要一次把所有事情做完。

今天,只要做一件事就好。

打開第 1 章建立的 repository,傳一行指令給 AI。

建立一個新分支,在 README 加上 1 行內容,然後上傳到 GitHub

黃色橫幅出現時,按下綠色按鈕,打開「Files changed」。

如果只有一行綠色,就算過關。

合併之前,用自己的眼睛確認那一行。

這就是擴大你能交給 AI 處理範圍的第一步。

對於 30 歲以上的工程師來說,致勝關鍵不在工作量,而在於設計。

與其每次工具更新就重學一遍,不如先定義好「在哪裡踩煞車」還比較快。

AWS 和 AI 的演進速度非常快。

去看別人在實際工作中測試留下的 log,比自己一個人苦苦追趕快得多。

在我的 AI × 工程實踐中,我不只留下成功的紀錄,也會把搞砸的、被排除的紀錄一起留下來。

歡迎追蹤我,別錯過未來的實戰心得!@dan_pro_man

一鍵儲存

使用 YouMind AI 深度閱讀爆款文章

保存原文、追問細節、總結觀點,並在一個 AI 工作空間裡把爆款文章沉澱成可複用筆記。

了解 YouMind
寫給創作者

把你的 Markdown 變成乾淨的 𝕏 文章

圖片上傳、表格、程式碼區塊,往 𝕏 上手動重排太痛苦。YouMind 把整篇 Markdown 一鍵轉成乾淨、可直接發佈的 𝕏 文章草稿。

試試 Markdown 轉 𝕏

更多可拆解樣本

近期爆款文章

探索更多爆款文章