使用 Git Bash 完成你的第一次开源贡献first-contributions 实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本文以 first-contributions 开源项目为练习靶场面向 Windows 用户手把手演示如何用 Git Bash 命令行完成一次真实的开源贡献流程——fork、clone、创建分支、修改文件、提交、推送、发起 Pull Request。读完本文你将掌握这套在任何开源项目中都会反复用到的标准贡献工作流并理解每条 Git 命令在流程中的实际作用。为什么用 Git Bash 学习第一次贡献第一次做一件事总是很难特别是涉及协作的时候。开源本质上是关于协作与共同进步的而 first-contributions 项目存在的意义就是让新手在亲自动手且不会搞砸任何事情的环境中完成第一次贡献。阅读文章和教程固然有用但没有什么比亲手走一遍流程更有效。在 Windows 上使用 Git Bash意味着你将完全通过命令行完成所有操作不依赖任何图形界面。这种方式能让你更清楚地看到每一步 Git 命令在做什么为后续深度使用 Git 打下扎实基础。请记住你越放松学得越快按照下列简单步骤操作即可。前置准备安装 Git Bash 并准备 GitHub 账户开始之前你需要完成两项准备在 Windows 上安装 Git BashGit for Windows 官方安装包自带 Git Bash 终端环境安装后即可在开始菜单中找到 Git Bash 应用。注册一个 GitHub 账户后续的 fork、clone、push 与 Pull Request 全部依赖你的 GitHub 身份。本仓库的 README.md 也给出了对应指引如果机器上还没有安装 Git需要先完成安装再继续后续流程。Fork 本仓库在云端创建你的副本Fork 是开源协作的第一步。点击 first-contributions 仓库页面右上角的Fork按钮即可将此仓库 Fork 到你的 GitHub 账户中。Fork 的本质是复制它会在你的 GitHub 账户下创建一份该仓库的独立副本。这份副本归你所有你可以随意修改、推送而不会影响原始仓库这正是开源协作的安全边界——你的所有改动都先在副本上进行确认无误后再通过 Pull Request 请求合并回上游。克隆仓库到本地现在将你 Fork 出来的仓库克隆到本地机器。重要不要克隆原始仓库。请到你自己的 fork 页面进行克隆。在你自己账户下的 first-contributions 仓库页面点击 Code 按钮然后复制下方的仓库链接repo-url。打开刚下载的 Git Bash 应用它看起来是一个命令行窗口。首先使用以下命令进入你希望保存项目的文件夹cd folder将folder替换为你实际想存放项目的目录路径。cdchange directory用于切换当前工作目录。接着使用你刚刚复制的链接运行克隆命令git clone repo-urlgit clone会把远程仓库的完整内容包括所有历史提交下载到本地。克隆完成后进入该目录并在 VS Code 中打开项目进行修改cd first-contributions code .从这一步开始你的所有操作都将在这个项目目录内进行。创建专属分支分支是 Git 协作的基石它让你在一个独立的工作副本上修改代码与主分支main互不干扰。使用以下命令创建分支并切换到该分支git checkout -b branch-namegit checkout -b的含义是创建分支并立即切换过去。分支命名建议采用add-你的名字的格式例如将branch-name替换为add-james-smith直观表明这个分支的目的是添加 James Smith 的名字。补充说明本仓库 README.md 的主流程教程使用的是git switch -c your-new-branch-name命令。如果你的 Git 版本较新git switch -c与git checkout -b等价如果遇到 switchis not a git command 的报错说明 Git 版本较旧请改用git checkout -b。做出必要修改并提交更改使用文本编辑器打开仓库根目录下的 Contributors.md 文件——这是本项目专门为贡献者准备的名单文件里面已经积累了数千位贡献者的名字。滚动到文件底部添加你的名字然后保存文件。例如如果你叫 James Smith添加如下内容这是本仓库贡献者名单的标准格式[James Smith](https://github.com/jamessmith)先通过以下命令查看是否有文件更改git statusgit status会列出当前工作区的状态哪些文件被修改、哪些文件尚未被跟踪。你会看到Contributors.md出现在修改列表中。现在提交你的更改。Git 的提交分为两步第一步将更改添加到暂存区staging areagit add file-name将file-name替换为实际文件名即git add Contributors.md。git add告诉 Git我要把哪些改动纳入这次提交。第二步提交更改git commit -m Add your-name to Contributors list请将your-name替换为你的名字例如git commit -m Add James Smith to Contributors list。-m参数用于附带提交说明规范的提交信息是良好协作习惯的起点。提交完成后你可以使用以下命令确认提交记录git log --onelinegit log --oneline以简洁的单行格式列出提交历史你应该能在最顶部看到刚刚创建的那条提交。推送更改到 GitHub完成本地提交后使用以下命令将更改推送到你的 GitHub forkgit push origin branch-name将branch-name替换为你之前创建的分支名如add-james-smith。origin是本地仓库对远程 fork 的默认别名git push会把本地分支的提交上传到远程同名分支。推送失败排查身份验证错误如果推送时遇到身份验证错误README.md 的排查章节给出了常见的处理思路报错信息常涉及password authentication was removed即平台已不再支持密码方式认证需要改用 Personal Access Token 或 SSH 密钥进行认证可以运行git remote -v检查你的远程仓库地址是否正确指向自己的 fork如果远程地址不正确可执行git remote set-url origin gitgithub.com:your-username/your_repo.git更正后再推送。提交更改供审查推送成功后访问你在 GitHub 上的 fork 仓库页面会看到醒目的Compare pull request按钮。点击它即可发起 Pull Request简称 PR。在 PR 页面确认改动内容无误后点击提交 pull request。你的改动就正式进入审查流程。不久之后项目维护者会将你的更改合并到主分支中合并后你会收到邮件通知。至此你就完成了开源协作中最经典的一条链路fork - clone - edit - PR。进阶学习Git 工作流场景完成第一次贡献后你可以继续深入学习 Git 的进阶操作。本仓库的 附加资料 汇总了多个高频实战场景包括修改最近一次提交amending a commit用于修正提交信息或补充遗漏的改动配置 Git 用户信息configuring git设置用户名、邮箱等个人配置保持 fork 与上游同步keeping your fork synced确保自己的 fork 不落后于原仓库避免后续 PR 冲突将提交移动到其他分支moving a commit to a different branch删除本地/远程分支removing branch from your repositoryPR 合并后的常规清理操作解决合并冲突resolving merge conflicts多人协作时的必修课还原已推送的提交reverting a commit与撤销本地提交undoing a commit压缩提交squashing commits用交互式 rebase 将多个提交合并为一个创建 .gitignore 文件、存储凭据storing credentials等。这些场景分别对应 docs/additional-material/git_workflow_scenarios/ 目录下的独立文档每个主题都配有具体操作步骤是完成基础教程之后的最佳进阶路线。使用其他工具的教程如果你对命令行之外的贡献方式感兴趣本仓库还提供了大量基于图形工具的教程例如 GitHub Desktop、Visual Studio Code、GitKraken、Sourcetree、IntelliJ IDEA 等分别位于 docs/gui-tool-tutorials/ 目录下CLI 方向的教程则位于 docs/cli-tool-tutorials/其中包括全程使用 GitHub CLIgh命令完成 fork、clone 与 PR 的纯终端方案。你可以回到项目主教程查看完整的教程索引。恭喜你你刚刚完成了标准的 fork - clone - edit - PR 工作流程——这是你未来在开源项目中常会用到的模式。现在你可以带着这套流程去为更多真实的开源项目贡献自己的力量了。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 使用 Git Bash 完成你的第一次开源贡献：first-contributions 实战指南
使用 Git Bash 完成你的第一次开源贡献first-contributions 实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本文以 first-contributions 开源项目为练习靶场面向 Windows 用户手把手演示如何用 Git Bash 命令行完成一次真实的开源贡献流程——fork、clone、创建分支、修改文件、提交、推送、发起 Pull Request。读完本文你将掌握这套在任何开源项目中都会反复用到的标准贡献工作流并理解每条 Git 命令在流程中的实际作用。为什么用 Git Bash 学习第一次贡献第一次做一件事总是很难特别是涉及协作的时候。开源本质上是关于协作与共同进步的而 first-contributions 项目存在的意义就是让新手在亲自动手且不会搞砸任何事情的环境中完成第一次贡献。阅读文章和教程固然有用但没有什么比亲手走一遍流程更有效。在 Windows 上使用 Git Bash意味着你将完全通过命令行完成所有操作不依赖任何图形界面。这种方式能让你更清楚地看到每一步 Git 命令在做什么为后续深度使用 Git 打下扎实基础。请记住你越放松学得越快按照下列简单步骤操作即可。前置准备安装 Git Bash 并准备 GitHub 账户开始之前你需要完成两项准备在 Windows 上安装 Git BashGit for Windows 官方安装包自带 Git Bash 终端环境安装后即可在开始菜单中找到 Git Bash 应用。注册一个 GitHub 账户后续的 fork、clone、push 与 Pull Request 全部依赖你的 GitHub 身份。本仓库的 README.md 也给出了对应指引如果机器上还没有安装 Git需要先完成安装再继续后续流程。Fork 本仓库在云端创建你的副本Fork 是开源协作的第一步。点击 first-contributions 仓库页面右上角的Fork按钮即可将此仓库 Fork 到你的 GitHub 账户中。Fork 的本质是复制它会在你的 GitHub 账户下创建一份该仓库的独立副本。这份副本归你所有你可以随意修改、推送而不会影响原始仓库这正是开源协作的安全边界——你的所有改动都先在副本上进行确认无误后再通过 Pull Request 请求合并回上游。克隆仓库到本地现在将你 Fork 出来的仓库克隆到本地机器。重要不要克隆原始仓库。请到你自己的 fork 页面进行克隆。在你自己账户下的 first-contributions 仓库页面点击 Code 按钮然后复制下方的仓库链接repo-url。打开刚下载的 Git Bash 应用它看起来是一个命令行窗口。首先使用以下命令进入你希望保存项目的文件夹cd folder将folder替换为你实际想存放项目的目录路径。cdchange directory用于切换当前工作目录。接着使用你刚刚复制的链接运行克隆命令git clone repo-urlgit clone会把远程仓库的完整内容包括所有历史提交下载到本地。克隆完成后进入该目录并在 VS Code 中打开项目进行修改cd first-contributions code .从这一步开始你的所有操作都将在这个项目目录内进行。创建专属分支分支是 Git 协作的基石它让你在一个独立的工作副本上修改代码与主分支main互不干扰。使用以下命令创建分支并切换到该分支git checkout -b branch-namegit checkout -b的含义是创建分支并立即切换过去。分支命名建议采用add-你的名字的格式例如将branch-name替换为add-james-smith直观表明这个分支的目的是添加 James Smith 的名字。补充说明本仓库 README.md 的主流程教程使用的是git switch -c your-new-branch-name命令。如果你的 Git 版本较新git switch -c与git checkout -b等价如果遇到 switchis not a git command 的报错说明 Git 版本较旧请改用git checkout -b。做出必要修改并提交更改使用文本编辑器打开仓库根目录下的 Contributors.md 文件——这是本项目专门为贡献者准备的名单文件里面已经积累了数千位贡献者的名字。滚动到文件底部添加你的名字然后保存文件。例如如果你叫 James Smith添加如下内容这是本仓库贡献者名单的标准格式[James Smith](https://github.com/jamessmith)先通过以下命令查看是否有文件更改git statusgit status会列出当前工作区的状态哪些文件被修改、哪些文件尚未被跟踪。你会看到Contributors.md出现在修改列表中。现在提交你的更改。Git 的提交分为两步第一步将更改添加到暂存区staging areagit add file-name将file-name替换为实际文件名即git add Contributors.md。git add告诉 Git我要把哪些改动纳入这次提交。第二步提交更改git commit -m Add your-name to Contributors list请将your-name替换为你的名字例如git commit -m Add James Smith to Contributors list。-m参数用于附带提交说明规范的提交信息是良好协作习惯的起点。提交完成后你可以使用以下命令确认提交记录git log --onelinegit log --oneline以简洁的单行格式列出提交历史你应该能在最顶部看到刚刚创建的那条提交。推送更改到 GitHub完成本地提交后使用以下命令将更改推送到你的 GitHub forkgit push origin branch-name将branch-name替换为你之前创建的分支名如add-james-smith。origin是本地仓库对远程 fork 的默认别名git push会把本地分支的提交上传到远程同名分支。推送失败排查身份验证错误如果推送时遇到身份验证错误README.md 的排查章节给出了常见的处理思路报错信息常涉及password authentication was removed即平台已不再支持密码方式认证需要改用 Personal Access Token 或 SSH 密钥进行认证可以运行git remote -v检查你的远程仓库地址是否正确指向自己的 fork如果远程地址不正确可执行git remote set-url origin gitgithub.com:your-username/your_repo.git更正后再推送。提交更改供审查推送成功后访问你在 GitHub 上的 fork 仓库页面会看到醒目的Compare pull request按钮。点击它即可发起 Pull Request简称 PR。在 PR 页面确认改动内容无误后点击提交 pull request。你的改动就正式进入审查流程。不久之后项目维护者会将你的更改合并到主分支中合并后你会收到邮件通知。至此你就完成了开源协作中最经典的一条链路fork - clone - edit - PR。进阶学习Git 工作流场景完成第一次贡献后你可以继续深入学习 Git 的进阶操作。本仓库的 附加资料 汇总了多个高频实战场景包括修改最近一次提交amending a commit用于修正提交信息或补充遗漏的改动配置 Git 用户信息configuring git设置用户名、邮箱等个人配置保持 fork 与上游同步keeping your fork synced确保自己的 fork 不落后于原仓库避免后续 PR 冲突将提交移动到其他分支moving a commit to a different branch删除本地/远程分支removing branch from your repositoryPR 合并后的常规清理操作解决合并冲突resolving merge conflicts多人协作时的必修课还原已推送的提交reverting a commit与撤销本地提交undoing a commit压缩提交squashing commits用交互式 rebase 将多个提交合并为一个创建 .gitignore 文件、存储凭据storing credentials等。这些场景分别对应 docs/additional-material/git_workflow_scenarios/ 目录下的独立文档每个主题都配有具体操作步骤是完成基础教程之后的最佳进阶路线。使用其他工具的教程如果你对命令行之外的贡献方式感兴趣本仓库还提供了大量基于图形工具的教程例如 GitHub Desktop、Visual Studio Code、GitKraken、Sourcetree、IntelliJ IDEA 等分别位于 docs/gui-tool-tutorials/ 目录下CLI 方向的教程则位于 docs/cli-tool-tutorials/其中包括全程使用 GitHub CLIgh命令完成 fork、clone 与 PR 的纯终端方案。你可以回到项目主教程查看完整的教程索引。恭喜你你刚刚完成了标准的 fork - clone - edit - PR 工作流程——这是你未来在开源项目中常会用到的模式。现在你可以带着这套流程去为更多真实的开源项目贡献自己的力量了。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考