核心概念
儲存庫
Repository
engineerdoge/math-ai-tools意思
一個由 Git 追蹤的專案資料夾，通常在 GitHub 上鏡像。
用途
當您要求檢查專案、提交變更或比較分支時，儲存庫是正在處理的單位。
範例
engineerdoge/math-ai-tools請求範例
檢查當前的儲存庫狀態。
程式設計
Git/GitHub 工作術語
了解儲存庫、branch、commit、同步、PR、衝突與安全操作的搜尋型參考資料。
33 個項目
核心概念
工作樹
Working tree
git status意思
当前在您的机器上检出的文件，包括尚未提交的编辑。
用途
運用它來區分已提交的歷史記錄和當前正在編輯的內容。
範例
git status請求範例
顯示工作樹中已變更的部分。
核心概念
暫存區
Staging area
git add src/components/SiteHeader.tsx意思
一個將包含在下一個提交中的臨時更改集合。
用途
它可以讓您僅提交屬於同一組的檔案或程式碼片段。
注意
暫存功能本身不會保存歷史記錄。 提交操作才是記錄歷史的。
範例
git add src/components/SiteHeader.tsx請求範例
僅限於 Git 術語頁面的文件。
核心概念
提交
Commit
git commit -m "Add Git terms reference"意思
儲存的倉庫歷史記錄中選定變更的快照。
用途
提交可以讓我們稍後審查、比較、部署或回滾變更。
範例
git commit -m "Add Git terms reference"請求範例
建立一個包含簡潔訊息的提交。
核心概念
差異
Diff
git diff意思
一個逐行查看兩個文件狀態之間的變化。
用途
差異是查看編輯實際做了什麼的最快方法，在提交之前。
範例
git diff請求範例
審查意外變更的差異。
分支
分支
Branch
qwen3.5意思
一個可以獨立於其他工作單元移動的命名工作單元。
用途
分支允許您在不立即更改主分支的情況下開發功能。
範例
qwen3.5請求範例
請告訴我，我目前在哪個分支上。
分支
main 分支
main branch
main意思
通常代表稳定或可生产的版本的分支。
用途
將您的工作分支與主分支進行比較，以查看變更了什麼。
範例
main請求範例
將此分支與主分支進行比較。
分支
checkout
checkout
git switch qwen3.5意思
將工作樹轉換為另一個分支或提交。
用途
在需要檢查或繼續在另一個分支上的工作時使用。
注意
未提交的修改可能會阻止切換分支，因為它們可能會被覆蓋。
範例
git switch qwen3.5請求範例
在檢查未提交的更改後，切换到 qwen3.5 分支。
分支
merge
merge
git merge main意思
將一個分支的變更合併到另一個分支中。
用途
使用 merge 將主要更新合併到您的功能分支，或將功能完成後合併到主要分支。
注意
合併可能會在兩個分支以不同的方式編輯相同的行時，產生衝突。
範例
git merge main請求範例
說明在將 main 合併到此分支之前會發生什麼。
分支
rebase
rebase
git rebase main意思
將一個分支的提交重新應用到另一個基礎提交之上。
用途
它可以使歷史記錄在合併功能分支之前看起來是線性的。
注意
`Rebase` 會重寫提交歷史，因此應謹慎地在共享分支上使用。
範例
git rebase main請求範例
不要立即重新整理。 首先解釋此分支的風險。
同步
clone
clone
git clone https://github.com/user/project.git意思
複製遠端儲存庫的本地副本。
用途
它通常是開始在現有 GitHub 專案上工作的第一步。
範例
git clone https://github.com/user/project.git請求範例
複製此儲存庫並顯示可用的分支。
同步
遠端。
remote
origin git@github.com:user/project.git意思
一個從本地倉庫到託管在其他位置的倉庫的命名連接。
用途
遠端設定決定了拉取和推送的通訊位置。
範例
origin git@github.com:user/project.git請求範例
顯示已配置的遠端儲存庫。
同步
fetch
fetch
git fetch origin意思
在不更改您的工作文件的情况下，下載遠端分支信息。
用途
在比較您的分支與最新的遠端狀態之前，使用 `fetch` 命令。
範例
git fetch origin請求範例
從原始版本獲取，然後將此分支與主分支進行比較。
同步
pull
pull
git pull origin main意思
獲取遠端變更並將其應用到當前分支。
用途
運用它來使用已推送到其他位置的工作，更新您的本地分支。
注意
請求拉取可能會更改您的工作分支，並可能導致衝突。
範例
git pull origin main請求範例
在下載之前，請檢查我是否有未提交的本地變更。
同步
push
push
git push origin qwen3.5意思
將本地提交上傳到遠端儲存庫。
用途
`Push` 命令將您的本地提交推送到 GitHub 或其他遠端。
注意
`Push` 命令僅上傳提交，而不上傳未提交的工作樹編輯。
範例
git push origin qwen3.5請求範例
在確認構建通過後，推送當前分支。
同步
origin
origin
git push origin qwen3.5意思
从远程克隆的存储库的默认名称。
用途
大部分推送、拉取和檢索範例使用 origin 作為遠端名稱。
範例
git push origin qwen3.5請求範例
檢查原始是否指向預期的 GitHub 儲存庫。
審查
請求拉取 (Pull Request)。
Pull Request
從 qwen3.5 開啟一個 PR 並合併到 main 分支意思
GitHub 的一個審查頁面，用於討論和合併分支的更改。
用途
使用 PR 來審查已變更的檔案、執行檢查、討論評論並安全地合併。
範例
從 qwen3.5 開啟一個 PR 並合併到 main 分支請求範例
總結應該包含在 PR 描述中的內容。
審查
審查
Review
審查請求的變更意思
檢查程式碼變更，以查找錯誤、回歸、可讀性問題以及缺失的測試。
用途
審查有助於在將分支合併到共享程式碼庫之前發現問題。
範例
審查請求的變更請求範例
審查此分支是否存在錯誤和缺失的測試。
衝突
合併衝突
Merge conflict
CONFLICT (content): src/app/page.tsx 文件中的內容衝突。意思
一種情況，Git 無法自動合併來自不同分支的變更。
用途
在合併可以繼續之前，您必須選擇正確的最終內容。
注意
不要盲目接受任何一方。 首先檢查預期的行為。
範例
CONFLICT (content): src/app/page.tsx 文件中的內容衝突。請求範例
說明衝突，並提出最安全的解決方案。
衝突
衝突標記
Conflict marker
<<<<<<< HEAD意思
文本標記，Git 會將其插入到檔案中，以顯示衝突的版本。
用途
標記顯示哪些部分來自您目前的分支，哪些部分來自接收到的分支。
注意
衝突標記不應保留在已提交的程式碼中。
範例
<<<<<<< HEAD請求範例
查找任何剩餘的衝突標記。
衝突
未追蹤的檔案
Untracked file
?? src/lib/git-github.ts意思
一個存在於文件夾中的文件，但尚未添加到 Git 跟踪中。
用途
新頁面和組件通常顯示為未追蹤狀態，直到進行分階段操作。
範例
?? src/lib/git-github.ts請求範例
列出未追蹤的文件，並告訴我哪些文件屬於此功能。
衝突
修改過的檔案
Modified file
M src/components/SiteHeader.tsx意思
一個被追蹤的文件，其內容與上次提交的版本不同。
用途
它可以幫助您查看哪些現有檔案受到目前工作所影響。
範例
M src/components/SiteHeader.tsx請求範例
顯示此任務的已修改檔案。
安全操作
暫存區
stash
git stash push -m "before branch switch"意思
暫時保存未提交的變更，以便工作樹可以恢復乾淨狀態。
用途
在切換分支之前，請使用 stash，如果您還沒有準備好提交。
注意
暫存的工作可能會被遺忘。 始終明確命名，並有意識地重新應用。
範例
git stash push -m "before branch switch"請求範例
在切換分支之前，使用清晰的訊息儲存我當前的修改。
安全操作
重置。
reset
git reset --soft HEAD~1意思
將分支或暫存狀態恢復到另一個提交或狀態。
用途
軟重置或混合重置可以在共享本地提交之前進行調整。
注意
硬重置可能會丟失工作。 在使用之前，請先詢問說明。
範例
git reset --soft HEAD~1請求範例
說明最安全地撤銷上次本地提交，而不會丟失變更。
安全操作
恢復。
revert
git revert abc1234意思
建立一個撤銷先前提交的新的提交。
用途
回滾通常比在提交後重寫歷史更安全。
範例
git revert abc1234請求範例
回滾有問題的提交，而無需重寫共享歷史。
安全操作
強制推送
force push
git push --force-with-lease origin qwen3.5意思
使用您的本地分支歷史覆蓋遠端分支。
用途
有時，在私有功能分支上重寫本地歷史記錄後會使用它。
注意
強制推送可能會覆蓋其他人的遠端提交。 最好使用 `force-with-lease`，並先確認。
範例
git push --force-with-lease origin qwen3.5請求範例
不要強制推送。 說明是否需要強制推送。
安全操作
.gitignore
.gitignore
.next/意思
一個告訴 Git 哪些文件或文件夾不應該被跟踪的文件。
用途
適用於構建輸出、依賴項、本機環境檔案和臨時檔案。
範例
.next/請求範例
檢查構建輸出是否已正確忽略。
指令
git status
git status
git status --short意思
一個命令，用於顯示分支、暫存的更改、已修改的檔案和未追蹤的檔案。
用途
在編輯、提交、拉取或切換分支之前，執行它。
範例
git status --short請求範例
執行 `git status` 並僅總結重要的變更。
指令
git log
git log
git log --oneline -5意思
一個用於查看提交歷史的命令。
用途
用於找到最近的提交、比較工作或識別要還原的提交。
範例
git log --oneline -5請求範例
以緊湊的格式顯示最後五個提交。
指令
git add
git add
git add src/lib/git-github.ts意思
一個命令，用於將更改暫存以進行下一個提交。
用途
當您想要進行專注的提交時，使用明確的路徑。
範例
git add src/lib/git-github.ts請求範例
僅限於為此頁面創建的文件。
指令
git commit
git commit
git commit -m "Add Git terms reference"意思
一個命令，用於將暫存的更改記錄到倉庫歷史中。
用途
使用一個訊息，說明變更了什麼以及為什麼它很重要。
範例
git commit -m "Add Git terms reference"請求範例
使用清晰的訊息提交已暫存的變更。
指令
git pull
git pull
git pull --ff-only意思
一個命令，用於從遠端分支更新當前分支。
用途
`--ff-only` 選項可以避免創建意外的合併提交。
範例
git pull --ff-only請求範例
僅在安全的情況下才使用 `ff-only`。
指令
git push
git push
git push origin HEAD意思
一個命令，用於將本地提交上傳到遠端分支。
用途
在測試通過且提交準備好共享之後，使用它。
範例
git push origin HEAD請求範例
在確認沒有 lint 或構建錯誤後，推送此分支。