實(shí)戰(zhàn)指南：Fork、Clone、改代碼、提 Pull Request 全流程詳解)
first-contributions 新手開源首貢獻(xiàn)實(shí)戰(zhàn)指南Fork、Clone、改代碼、提 Pull Request 全流程詳解【免費(fèi)下載鏈接】first-contributions? Help beginners to contribute to open source projects項(xiàng)目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本指南以開源項(xiàng)目 first-contributions 的官方教程文檔docs/translations/README.no.md 挪威語(yǔ)版本為骨架系統(tǒng)講解新手向開源項(xiàng)目提交第一個(gè)貢獻(xiàn)的完整流程Fork → Clone → 新建分支 → 修改并提交 → Push → 提交 Pull Request。讀完本文你將掌握這套在所有開源協(xié)作中反復(fù)出現(xiàn)的標(biāo)準(zhǔn)工作流并學(xué)會(huì)處理最常見(jiàn)的 push 認(rèn)證報(bào)錯(cuò)為后續(xù)參與其他開源項(xiàng)目打下扎實(shí)基礎(chǔ)。項(xiàng)目與文檔背景first-contributions 是一個(gè)專門幫助初學(xué)者邁出開源貢獻(xiàn)第一步的教學(xué)型倉(cāng)庫(kù)。正如其挪威語(yǔ) README 開篇所述第一次做某件事總是困難的尤其是在與他人協(xié)作時(shí)犯錯(cuò)會(huì)讓人有壓力。我們希望讓新手更容易為開源項(xiàng)目做出貢獻(xiàn)。原文Det er alltid vanskelig ? gj?re noe for f?rste gang... Vi ?nsker ? gj?re det lettere for nybegynnere ? bidra til open-source.閱讀文章和觀看視頻可以有所幫助但紙上得來(lái)終覺(jué)淺該項(xiàng)目的核心思路是讓新手直接上手實(shí)踐通過(guò)一個(gè)真實(shí)可運(yùn)行的最小任務(wù)——把自己的名字寫進(jìn) Contributors.md——完整體驗(yàn)一次真實(shí)的開源貢獻(xiàn)流程。值得一提的是Contributors.md 當(dāng)前已積累了數(shù)千行貢獻(xiàn)者名單本倉(cāng)庫(kù)中該文件約有 5920 行這正是無(wú)數(shù)開發(fā)者通過(guò)本教程完成首次貢獻(xiàn)后留下的真實(shí)痕跡也是本教程先實(shí)踐、后理論理念的最好證明。同時(shí)README 已被翻譯為 80 多種語(yǔ)言完整索引見(jiàn) docs/translations/Translations.md挪威語(yǔ)版本即位于 docs/translations/README.no.md。若你不習(xí)慣使用終端可以跳到文末的其他工具教程一節(jié)那里提供了 GitHub Desktop、VS Code、IntelliJ 等 GUI 工具的教學(xué)入口。前置準(zhǔn)備安裝 Git在執(zhí)行任何操作之前請(qǐng)確認(rèn)你的機(jī)器上已經(jīng)安裝了 Git。如果尚未安裝請(qǐng)先參照官方安裝文檔完成配置本倉(cāng)庫(kù)的 docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md 與 installing-git-arch.md 分別提供了 Ubuntu 與 Arch Linux 下的安裝指引。安裝完成后建議先按 docs/additional-material/git_workflow_scenarios/configuring-git.md 配置你的用戶名與郵箱git config --global user.name與git config --global user.email否則第一次git commit會(huì)被 Git 攔截并提示 Please tell me who you are。第一步Fork 這個(gè)倉(cāng)庫(kù)Fork 操作的本質(zhì)是在你自己的賬號(hào)下創(chuàng)建一份當(dāng)前倉(cāng)庫(kù)的完整副本。操作方式很簡(jiǎn)單——點(diǎn)擊本倉(cāng)庫(kù)頁(yè)面頂部的Fork按鈕即可。完成之后你的 GitHub 賬號(hào)下就會(huì)出現(xiàn)一個(gè)名為first-contributions的倉(cāng)庫(kù)副本在 GitHub 中倉(cāng)庫(kù)被稱為 repository。Fork 與直接 Clone 的關(guān)鍵區(qū)別在于你 Fork 出的副本歸你所有你可以自由地向它 Push 代碼而原始倉(cāng)庫(kù)upstream你沒(méi)有寫權(quán)限只能通過(guò) Pull Request 請(qǐng)求維護(hù)者合入你的改動(dòng)。這正是整個(gè)協(xié)作流程的起點(diǎn)。第二步Clone 倉(cāng)庫(kù)到本地Fork 完成后需要把副本從 GitHub 拉到你的本地機(jī)器。操作如下進(jìn)入你的 GitHub 賬號(hào)打開剛 Fork 出來(lái)的倉(cāng)庫(kù)點(diǎn)擊綠色的Code按鈕復(fù)制彈窗中給出的倉(cāng)庫(kù)地址URL。然后在終端中執(zhí)行克隆命令git clone din-link把din-link替換為你上一步復(fù)制的地址。例如如果你的 GitHub 用戶名是ditt-brukernavn則命令形如git clone https://github.com/ditt-brukernavn/first-contributions.git這條命令會(huì)把 first-contributions 項(xiàng)目的全部?jī)?nèi)容從你的 GitHub 賬號(hào)復(fù)制到本地機(jī)器。第三步創(chuàng)建自己的分支Branch分支branch是 Git 最重要的協(xié)作機(jī)制之一它讓你可以在不影響主分支main/master的情況下獨(dú)立開發(fā)這也是開源項(xiàng)目要求貢獻(xiàn)者在獨(dú)立分支上工作的原因。相關(guān)理念可進(jìn)一步閱讀 docs/additional-material/git_workflow_scenarios/why-using-branches.md。先進(jìn)入項(xiàng)目目錄cd first-contributions然后使用git checkout命令創(chuàng)建并切換到新分支git checkout -b navn-til-branch-her其中navn-til-branch-her替換為你想要的分支名。例如git checkout -b add-alonzo-church分支名不一定要包含add這個(gè)詞但在向 Contributors 名單添加自己這個(gè)場(chǎng)景下以add-開頭是符合慣例的命名方式能讓維護(hù)者一眼看出這個(gè)分支做了什么。把示例中的alonzo-church換成你自己的名字即可。第四步修改文件并提交Commit現(xiàn)在進(jìn)入本次貢獻(xiàn)的核心環(huán)節(jié)——修改文件。用任意文本編輯器打開倉(cāng)庫(kù)根目錄下的 Contributors.md把你的名字添加進(jìn)貢獻(xiàn)者名單。注意原文檔的明確要求不要加在文件開頭或結(jié)尾加在中間任意位置即可。保存文件后回到終端執(zhí)行g(shù)it status你會(huì)看到 Git 報(bào)告Contributors.md已被修改——git status用于查看工作區(qū)的變更狀態(tài)是日常開發(fā)中最常用的檢查命令之一。接下來(lái)把改動(dòng)加入暫存區(qū)staging areagit add Contributors.md然后提交到當(dāng)前分支git commit -m Add ditt-navn to Contributors list把ditt-navn替換成你的名字。-m參數(shù)用于直接在命令行指定提交信息避免打開文本編輯器。一次規(guī)范的提交應(yīng)該只包含邏輯相關(guān)的改動(dòng)、附有清晰描述性的提交信息——正如上面的 Add XXX to Contributors list。第五步Push 改動(dòng)到 GitHub本地提交完成后需要把改動(dòng)推送到 GitHub 上的你的 Fork 倉(cāng)庫(kù)git push origin navn-p?-din-branch把navn-p?-din-branch替換為你第三步創(chuàng)建的分支名。這里origin是指向你自己 Fork 倉(cāng)庫(kù)的遠(yuǎn)程remote名稱。常見(jiàn)報(bào)錯(cuò)認(rèn)證失敗Authentication Error如果你是第一次通過(guò) HTTPS 方式 Push很可能會(huì)遇到如下報(bào)錯(cuò)remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. fatal: Authentication failed for https://github.com/ditt-brukernavn/first-contributions.git/原因自 2021 年 8 月 13 日起GitHub 已全面移除密碼認(rèn)證改用**個(gè)人訪問(wèn)令牌Personal Access Token**或SSH 密鑰完成認(rèn)證。解決方案是配置 SSH 密鑰生成密鑰并添加到你的 GitHub 賬號(hào)后將本地倉(cāng)庫(kù)的遠(yuǎn)程地址從 HTTPS 切換為 SSH 形式。首先檢查當(dāng)前遠(yuǎn)程地址git remote -v如果輸出形如origin https://github.com/ditt-brukernavn/ditt-repo.git (fetch) origin https://github.com/ditt-brukernavn/ditt-repo.git (push)則執(zhí)行下面的命令把遠(yuǎn)程地址改為 SSH 形式git remote set-url origin gitgithub.com:ditt-brukernavn/ditt-repo.git否則即使配置了令牌你仍然可能被反復(fù)要求輸入用戶名和密碼并最終報(bào)認(rèn)證錯(cuò)誤。切換為 SSH 地址后Push 將使用本機(jī) SSH 密鑰完成認(rèn)證不再需要交互式輸入賬號(hào)密碼。第六步提交 Pull RequestPR改動(dòng)已經(jīng)推到你的 Fork 倉(cāng)庫(kù)現(xiàn)在需要請(qǐng)求上游維護(hù)者合入這些改動(dòng)這一步靠Pull Request完成?；氐?GitHub 上你的 Fork 倉(cāng)庫(kù)頁(yè)面頁(yè)面上會(huì)出現(xiàn)一個(gè)醒目的Compare pull request按鈕點(diǎn)擊它確認(rèn) PR 的比較范圍base 是上游倉(cāng)庫(kù)的 main 分支compare 是你的新分支提交 Pull Request。提交后維護(hù)者會(huì)把你的改動(dòng)合并進(jìn)項(xiàng)目的主分支合并完成時(shí)你會(huì)收到一封通知郵件。至此你就完成了人生第一次開源貢獻(xiàn)完成之后這套流程的意義與進(jìn)階方向恭喜你剛剛完整走通了開源協(xié)作中最經(jīng)典的fork → clone → edit → PR標(biāo)準(zhǔn)流程。這套流程絕不僅限于 first-contributions 這一個(gè)倉(cāng)庫(kù)——它幾乎出現(xiàn)在你今后參與的每一個(gè)開源項(xiàng)目中是你必須內(nèi)化的核心技能。在此基礎(chǔ)上可以進(jìn)一步探索以下方向保持 Fork 與上游同步當(dāng)上游倉(cāng)庫(kù)有了新提交你的 Fork 會(huì)落后。此時(shí)需要配置upstream遠(yuǎn)程并執(zhí)行 fetch、rebase、push 三部曲完整的三角形工作流講解見(jiàn) docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md。進(jìn)階 Git 技巧合集上游維護(hù)者整理了一份進(jìn)階資料索引 docs/additional-material/git_workflow_scenarios/additional-material.md涵蓋修改最近一次提交git commit --amend修正提交信息或把遺漏的改動(dòng)并入上一次提交壓縮提交squashing commits用交互式 rebase 把多個(gè)提交合并為一個(gè)這是開源評(píng)審中常被要求做的事解決合并沖突resolving merge conflicts當(dāng)多人修改同一文件時(shí)如何手動(dòng)處理沖突標(biāo)記并完成合并撤銷提交reverting / undoing a commit回滾已推送或本地的提交查看提交日志check commit loggit log的常用變體與參數(shù)以及配置 Git、創(chuàng)建 .gitignore、保存憑據(jù)、Git Flow 分支模型 等主題。參與真實(shí)項(xiàng)目在掌握流程后你完全有能力去其他開源項(xiàng)目貢獻(xiàn)代碼了。許多項(xiàng)目會(huì)為新手標(biāo)注good first issue類問(wèn)題適合作為起步練習(xí)。其他工具教程不使用終端也能完成貢獻(xiàn)如果你對(duì)命令行感到吃力倉(cāng)庫(kù)同樣提供了基于 GUI 工具的完整教學(xué)。下表列出了六種主流工具的教學(xué)文檔入口對(duì)應(yīng)文檔位于 docs/gui-tool-tutorials/ 目錄許多還有多語(yǔ)言版本工具教學(xué)文檔GitHub Desktopgithub-desktop-tutorial.mdVisual Studio 2017github-windows-vs2017-tutorial.mdGitKrakengitkraken-tutorial.mdVisual Studio Codegithub-windows-vs-code-tutorial.mdAtlassian Sourcetreesourcetree-macos-tutorial.mdIntelliJ IDEAgithub-windows-intellij-tutorial.md這些 GUI 教程走的是與命令行完全一致的底層流程同樣是 Fork、Clone、建分支、修改、提交、Push、提 PR只是把命令操作封裝成了可視化界面適合作為終端操作之外的另一條學(xué)習(xí)路徑。小結(jié)first-contributions 用一個(gè)名字、一個(gè) PR的最小任務(wù)把開源協(xié)作中最核心的fork → clone → edit → PR流程完整演練了一遍。本文從 Fork 出發(fā)逐步完成了倉(cāng)庫(kù)克隆、分支創(chuàng)建、文件修改、本地提交、遠(yuǎn)程推送、認(rèn)證問(wèn)題排查與 Pull Request 提交并延伸到了同步上游、壓縮提交、解決沖突等進(jìn)階 Git 技巧。建議你立刻動(dòng)手實(shí)踐一次——第一次提交的成就感正是后續(xù)持續(xù)參與開源的起點(diǎn)?！久赓M(fèi)下載鏈接】first-contributions? Help beginners to contribute to open source projects項(xiàng)目地址: https://gitcode.com/gh_mirrors/fi/first-contributions創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 first-contributions 新手開源首貢獻(xiàn)實(shí)戰(zhàn)指南：Fork、Clone、改代碼、提 Pull Request 全流程詳解
first-contributions 新手開源首貢獻(xiàn)實(shí)戰(zhàn)指南Fork、Clone、改代碼、提 Pull Request 全流程詳解【免費(fèi)下載鏈接】first-contributions? Help beginners to contribute to open source projects項(xiàng)目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本指南以開源項(xiàng)目 first-contributions 的官方教程文檔docs/translations/README.no.md 挪威語(yǔ)版本為骨架系統(tǒng)講解新手向開源項(xiàng)目提交第一個(gè)貢獻(xiàn)的完整流程Fork → Clone → 新建分支 → 修改并提交 → Push → 提交 Pull Request。讀完本文你將掌握這套在所有開源協(xié)作中反復(fù)出現(xiàn)的標(biāo)準(zhǔn)工作流并學(xué)會(huì)處理最常見(jiàn)的 push 認(rèn)證報(bào)錯(cuò)為后續(xù)參與其他開源項(xiàng)目打下扎實(shí)基礎(chǔ)。項(xiàng)目與文檔背景first-contributions 是一個(gè)專門幫助初學(xué)者邁出開源貢獻(xiàn)第一步的教學(xué)型倉(cāng)庫(kù)。正如其挪威語(yǔ) README 開篇所述第一次做某件事總是困難的尤其是在與他人協(xié)作時(shí)犯錯(cuò)會(huì)讓人有壓力。我們希望讓新手更容易為開源項(xiàng)目做出貢獻(xiàn)。原文Det er alltid vanskelig ? gj?re noe for f?rste gang... Vi ?nsker ? gj?re det lettere for nybegynnere ? bidra til open-source.閱讀文章和觀看視頻可以有所幫助但紙上得來(lái)終覺(jué)淺該項(xiàng)目的核心思路是讓新手直接上手實(shí)踐通過(guò)一個(gè)真實(shí)可運(yùn)行的最小任務(wù)——把自己的名字寫進(jìn) Contributors.md——完整體驗(yàn)一次真實(shí)的開源貢獻(xiàn)流程。值得一提的是Contributors.md 當(dāng)前已積累了數(shù)千行貢獻(xiàn)者名單本倉(cāng)庫(kù)中該文件約有 5920 行這正是無(wú)數(shù)開發(fā)者通過(guò)本教程完成首次貢獻(xiàn)后留下的真實(shí)痕跡也是本教程先實(shí)踐、后理論理念的最好證明。同時(shí)README 已被翻譯為 80 多種語(yǔ)言完整索引見(jiàn) docs/translations/Translations.md挪威語(yǔ)版本即位于 docs/translations/README.no.md。若你不習(xí)慣使用終端可以跳到文末的其他工具教程一節(jié)那里提供了 GitHub Desktop、VS Code、IntelliJ 等 GUI 工具的教學(xué)入口。前置準(zhǔn)備安裝 Git在執(zhí)行任何操作之前請(qǐng)確認(rèn)你的機(jī)器上已經(jīng)安裝了 Git。如果尚未安裝請(qǐng)先參照官方安裝文檔完成配置本倉(cāng)庫(kù)的 docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md 與 installing-git-arch.md 分別提供了 Ubuntu 與 Arch Linux 下的安裝指引。安裝完成后建議先按 docs/additional-material/git_workflow_scenarios/configuring-git.md 配置你的用戶名與郵箱git config --global user.name與git config --global user.email否則第一次git commit會(huì)被 Git 攔截并提示 Please tell me who you are。第一步Fork 這個(gè)倉(cāng)庫(kù)Fork 操作的本質(zhì)是在你自己的賬號(hào)下創(chuàng)建一份當(dāng)前倉(cāng)庫(kù)的完整副本。操作方式很簡(jiǎn)單——點(diǎn)擊本倉(cāng)庫(kù)頁(yè)面頂部的Fork按鈕即可。完成之后你的 GitHub 賬號(hào)下就會(huì)出現(xiàn)一個(gè)名為first-contributions的倉(cāng)庫(kù)副本在 GitHub 中倉(cāng)庫(kù)被稱為 repository。Fork 與直接 Clone 的關(guān)鍵區(qū)別在于你 Fork 出的副本歸你所有你可以自由地向它 Push 代碼而原始倉(cāng)庫(kù)upstream你沒(méi)有寫權(quán)限只能通過(guò) Pull Request 請(qǐng)求維護(hù)者合入你的改動(dòng)。這正是整個(gè)協(xié)作流程的起點(diǎn)。第二步Clone 倉(cāng)庫(kù)到本地Fork 完成后需要把副本從 GitHub 拉到你的本地機(jī)器。操作如下進(jìn)入你的 GitHub 賬號(hào)打開剛 Fork 出來(lái)的倉(cāng)庫(kù)點(diǎn)擊綠色的Code按鈕復(fù)制彈窗中給出的倉(cāng)庫(kù)地址URL。然后在終端中執(zhí)行克隆命令git clone din-link把din-link替換為你上一步復(fù)制的地址。例如如果你的 GitHub 用戶名是ditt-brukernavn則命令形如git clone https://github.com/ditt-brukernavn/first-contributions.git這條命令會(huì)把 first-contributions 項(xiàng)目的全部?jī)?nèi)容從你的 GitHub 賬號(hào)復(fù)制到本地機(jī)器。第三步創(chuàng)建自己的分支Branch分支branch是 Git 最重要的協(xié)作機(jī)制之一它讓你可以在不影響主分支main/master的情況下獨(dú)立開發(fā)這也是開源項(xiàng)目要求貢獻(xiàn)者在獨(dú)立分支上工作的原因。相關(guān)理念可進(jìn)一步閱讀 docs/additional-material/git_workflow_scenarios/why-using-branches.md。先進(jìn)入項(xiàng)目目錄cd first-contributions然后使用git checkout命令創(chuàng)建并切換到新分支git checkout -b navn-til-branch-her其中navn-til-branch-her替換為你想要的分支名。例如git checkout -b add-alonzo-church分支名不一定要包含add這個(gè)詞但在向 Contributors 名單添加自己這個(gè)場(chǎng)景下以add-開頭是符合慣例的命名方式能讓維護(hù)者一眼看出這個(gè)分支做了什么。把示例中的alonzo-church換成你自己的名字即可。第四步修改文件并提交Commit現(xiàn)在進(jìn)入本次貢獻(xiàn)的核心環(huán)節(jié)——修改文件。用任意文本編輯器打開倉(cāng)庫(kù)根目錄下的 Contributors.md把你的名字添加進(jìn)貢獻(xiàn)者名單。注意原文檔的明確要求不要加在文件開頭或結(jié)尾加在中間任意位置即可。保存文件后回到終端執(zhí)行g(shù)it status你會(huì)看到 Git 報(bào)告Contributors.md已被修改——git status用于查看工作區(qū)的變更狀態(tài)是日常開發(fā)中最常用的檢查命令之一。接下來(lái)把改動(dòng)加入暫存區(qū)staging areagit add Contributors.md然后提交到當(dāng)前分支git commit -m Add ditt-navn to Contributors list把ditt-navn替換成你的名字。-m參數(shù)用于直接在命令行指定提交信息避免打開文本編輯器。一次規(guī)范的提交應(yīng)該只包含邏輯相關(guān)的改動(dòng)、附有清晰描述性的提交信息——正如上面的 Add XXX to Contributors list。第五步Push 改動(dòng)到 GitHub本地提交完成后需要把改動(dòng)推送到 GitHub 上的你的 Fork 倉(cāng)庫(kù)git push origin navn-p?-din-branch把navn-p?-din-branch替換為你第三步創(chuàng)建的分支名。這里origin是指向你自己 Fork 倉(cāng)庫(kù)的遠(yuǎn)程remote名稱。常見(jiàn)報(bào)錯(cuò)認(rèn)證失敗Authentication Error如果你是第一次通過(guò) HTTPS 方式 Push很可能會(huì)遇到如下報(bào)錯(cuò)remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. fatal: Authentication failed for https://github.com/ditt-brukernavn/first-contributions.git/原因自 2021 年 8 月 13 日起GitHub 已全面移除密碼認(rèn)證改用**個(gè)人訪問(wèn)令牌Personal Access Token**或SSH 密鑰完成認(rèn)證。解決方案是配置 SSH 密鑰生成密鑰并添加到你的 GitHub 賬號(hào)后將本地倉(cāng)庫(kù)的遠(yuǎn)程地址從 HTTPS 切換為 SSH 形式。首先檢查當(dāng)前遠(yuǎn)程地址git remote -v如果輸出形如origin https://github.com/ditt-brukernavn/ditt-repo.git (fetch) origin https://github.com/ditt-brukernavn/ditt-repo.git (push)則執(zhí)行下面的命令把遠(yuǎn)程地址改為 SSH 形式git remote set-url origin gitgithub.com:ditt-brukernavn/ditt-repo.git否則即使配置了令牌你仍然可能被反復(fù)要求輸入用戶名和密碼并最終報(bào)認(rèn)證錯(cuò)誤。切換為 SSH 地址后Push 將使用本機(jī) SSH 密鑰完成認(rèn)證不再需要交互式輸入賬號(hào)密碼。第六步提交 Pull RequestPR改動(dòng)已經(jīng)推到你的 Fork 倉(cāng)庫(kù)現(xiàn)在需要請(qǐng)求上游維護(hù)者合入這些改動(dòng)這一步靠Pull Request完成?；氐?GitHub 上你的 Fork 倉(cāng)庫(kù)頁(yè)面頁(yè)面上會(huì)出現(xiàn)一個(gè)醒目的Compare pull request按鈕點(diǎn)擊它確認(rèn) PR 的比較范圍base 是上游倉(cāng)庫(kù)的 main 分支compare 是你的新分支提交 Pull Request。提交后維護(hù)者會(huì)把你的改動(dòng)合并進(jìn)項(xiàng)目的主分支合并完成時(shí)你會(huì)收到一封通知郵件。至此你就完成了人生第一次開源貢獻(xiàn)完成之后這套流程的意義與進(jìn)階方向恭喜你剛剛完整走通了開源協(xié)作中最經(jīng)典的fork → clone → edit → PR標(biāo)準(zhǔn)流程。這套流程絕不僅限于 first-contributions 這一個(gè)倉(cāng)庫(kù)——它幾乎出現(xiàn)在你今后參與的每一個(gè)開源項(xiàng)目中是你必須內(nèi)化的核心技能。在此基礎(chǔ)上可以進(jìn)一步探索以下方向保持 Fork 與上游同步當(dāng)上游倉(cāng)庫(kù)有了新提交你的 Fork 會(huì)落后。此時(shí)需要配置upstream遠(yuǎn)程并執(zhí)行 fetch、rebase、push 三部曲完整的三角形工作流講解見(jiàn) docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md。進(jìn)階 Git 技巧合集上游維護(hù)者整理了一份進(jìn)階資料索引 docs/additional-material/git_workflow_scenarios/additional-material.md涵蓋修改最近一次提交git commit --amend修正提交信息或把遺漏的改動(dòng)并入上一次提交壓縮提交squashing commits用交互式 rebase 把多個(gè)提交合并為一個(gè)這是開源評(píng)審中常被要求做的事解決合并沖突resolving merge conflicts當(dāng)多人修改同一文件時(shí)如何手動(dòng)處理沖突標(biāo)記并完成合并撤銷提交reverting / undoing a commit回滾已推送或本地的提交查看提交日志check commit loggit log的常用變體與參數(shù)以及配置 Git、創(chuàng)建 .gitignore、保存憑據(jù)、Git Flow 分支模型 等主題。參與真實(shí)項(xiàng)目在掌握流程后你完全有能力去其他開源項(xiàng)目貢獻(xiàn)代碼了。許多項(xiàng)目會(huì)為新手標(biāo)注good first issue類問(wèn)題適合作為起步練習(xí)。其他工具教程不使用終端也能完成貢獻(xiàn)如果你對(duì)命令行感到吃力倉(cāng)庫(kù)同樣提供了基于 GUI 工具的完整教學(xué)。下表列出了六種主流工具的教學(xué)文檔入口對(duì)應(yīng)文檔位于 docs/gui-tool-tutorials/ 目錄許多還有多語(yǔ)言版本工具教學(xué)文檔GitHub Desktopgithub-desktop-tutorial.mdVisual Studio 2017github-windows-vs2017-tutorial.mdGitKrakengitkraken-tutorial.mdVisual Studio Codegithub-windows-vs-code-tutorial.mdAtlassian Sourcetreesourcetree-macos-tutorial.mdIntelliJ IDEAgithub-windows-intellij-tutorial.md這些 GUI 教程走的是與命令行完全一致的底層流程同樣是 Fork、Clone、建分支、修改、提交、Push、提 PR只是把命令操作封裝成了可視化界面適合作為終端操作之外的另一條學(xué)習(xí)路徑。小結(jié)first-contributions 用一個(gè)名字、一個(gè) PR的最小任務(wù)把開源協(xié)作中最核心的fork → clone → edit → PR流程完整演練了一遍。本文從 Fork 出發(fā)逐步完成了倉(cāng)庫(kù)克隆、分支創(chuàng)建、文件修改、本地提交、遠(yuǎn)程推送、認(rèn)證問(wèn)題排查與 Pull Request 提交并延伸到了同步上游、壓縮提交、解決沖突等進(jìn)階 Git 技巧。建議你立刻動(dòng)手實(shí)踐一次——第一次提交的成就感正是后續(xù)持續(xù)參與開源的起點(diǎn)?！久赓M(fèi)下載鏈接】first-contributions? Help beginners to contribute to open source projects項(xiàng)目地址: https://gitcode.com/gh_mirrors/fi/first-contributions創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考