first-contributions 全终端实战用 GitHub CLI 完成从 Fork 到 Pull Request 的首次开源贡献【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本指南面向希望在终端中完成全部操作的开发者基于 first-contributions 仓库的官方 GitHub CLI 教程逐步演示如何用gh命令完成 fork → clone → edit → pull request 的完整开源贡献流程。读完本文你将掌握gh auth login、gh repo fork、gh pr create等核心命令以及配套的 Git 分支、提交与推送操作并学会处理推送时的身份验证问题。教程定位与前置条件这个仓库的核心目标是帮助新手完成第一次开源贡献项目描述Help beginners to contribute to open source projects主教程见 README.md。本教程则是其 CLI 分支完全抛弃图形界面一切都在终端中完成。它比 GUI 教程稍有挑战但步骤清晰、完全可照做且整个流程是开源社区最常见的协作方式。开始之前你需要具备两样东西已安装 Git针对不同系统的安装方法可参考 installing-git-ubuntu.md 与 installing-git-arch.md一个 GitHub 账号第一步安装并登录 GitHub CLI首先在你的系统中安装github-cli工具即gh命令行工具。安装完成后执行登录命令gh auth login按照交互提示完成认证即可。登录后gh会获得访问你 GitHub 账号的权限后续的 fork、创建 PR 等操作都不需要再打开浏览器手动操作。第二步Fork 仓库——一条命令完成Fork复制上游仓库到你的账号下只需要一条命令gh repo fork firstcontributions/first-contributions重要提示命令执行过程中会询问你是否需要同时克隆仓库到本地请选择yes这样 fork 与 clone 一步到位。这也是gh repo fork相比在网页上手动点 Fork 按钮README.md 中的常规方式的最大优势整个流程无需离开终端。如果你在后续步骤中选择了不同答案也可以随时用常规命令补充克隆例如git clone gitgithub.com:你的用户名/first-contributions.git第三步创建你的专属分支接下来用 Git 创建分支。分支命名建议采用add-你的名字的形式例如你的名字是 taras-shevchenkogit switch -c add-taras-shevchenko其中-c表示 create即创建并切换到新分支。如果你使用的 Git 版本较老、不支持git switch可以用等价命令git checkout -b add-taras-shevchenko。第四步修改文件并提交在文本编辑器中打开仓库根目录下的 Contributors.md 文件把你的名字加到文件中建议加在文件中间任意位置而不是文件开头或结尾然后保存。回到项目目录执行git status你会看到工作区中已被修改的文件。接下来把改动加入暂存区并提交git add Contributors.mdgit commit -m Add taras-shevchenko to Contributors list提交信息中的taras-shevchenko请替换为你的实际名字。第五步推送分支到 GitHub将你的分支推送到远端即你在第二步 fork 出来的仓库git push origin -u your-branch-name把your-branch-name替换为你在第三步创建的分支名。-u即--set-upstream用于建立本地分支与远端分支的跟踪关系之后再次推送只需执行git push。推送报错身份验证失败怎么办如果你在推送时看到类似下面的错误remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for https://github.com/your-username/first-contributions.git/这说明 GitHub 已经不再接受用账号密码进行 Git 操作认证该变更自 2021 年 8 月起生效。解决办法是为你的 GitHub 账号配置 SSH 密钥并改用 SSH 协议推送。本仓库的 storing-credentials.md 对凭据存储方式有更详细的说明配置好 SSH 密钥后还可以用以下命令检查并修正远端地址git remote -v git remote set-url origin gitgithub.com:你的用户名/first-contributions.git第六步用 gh 创建 Pull Request在仓库目录下执行下面的命令gh会基于当前分支与上游仓库firstcontributions/first-contributions自动生成 Pull Requestgh pr create --repo firstcontributions/first-contributions按提示填写标题与描述后提交即可。之后你随时可以用下面的命令查看 PR 状态gh statusgh status会列出与你当前账号相关的 PR 及其检查状态让你在终端中就能追踪 PR 的全生命周期这也是 CLI 工作流相比网页操作的便利之处。接下来可以做什么恭喜你刚刚完整走过了开源贡献的标准流程fork → clone → edit → pull request这正是你日后参与任何开源项目都会反复遇到的协作模式。同步 fork随着项目持续演进你的 fork 会逐渐落后于上游。此时可以参考 keeping-your-fork-synced-with-this-repository.md 学习三角工作流通过git remote add upstream、git fetch upstream、git rebase upstream/main、git push origin main让本地与 fork 保持最新。进阶 Git 技巧本仓库还整理了 amending-a-commit.md修改最近一次提交、squashing-commits.md合并提交、resolving-merge-conflicts.md解决合并冲突、reverting-a-commit.md撤销已推送的提交等实战文档入口见 additional-material.md。尝试其他工具如果你之后想体验图形化流程仓库还提供了 GitHub Desktop、VS Code、GitKraken、Sourcetree 等工具的教程见 README.md 的教程列表也可以在 docs/translations/README.zh-cn.md 查看中文版主教程。现在带上这套全终端工作流去为更多开源项目贡献你的力量吧。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 first-contributions 全终端实战：用 GitHub CLI 完成从 Fork 到 Pull Request 的首次开源贡献
first-contributions 全终端实战用 GitHub CLI 完成从 Fork 到 Pull Request 的首次开源贡献【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本指南面向希望在终端中完成全部操作的开发者基于 first-contributions 仓库的官方 GitHub CLI 教程逐步演示如何用gh命令完成 fork → clone → edit → pull request 的完整开源贡献流程。读完本文你将掌握gh auth login、gh repo fork、gh pr create等核心命令以及配套的 Git 分支、提交与推送操作并学会处理推送时的身份验证问题。教程定位与前置条件这个仓库的核心目标是帮助新手完成第一次开源贡献项目描述Help beginners to contribute to open source projects主教程见 README.md。本教程则是其 CLI 分支完全抛弃图形界面一切都在终端中完成。它比 GUI 教程稍有挑战但步骤清晰、完全可照做且整个流程是开源社区最常见的协作方式。开始之前你需要具备两样东西已安装 Git针对不同系统的安装方法可参考 installing-git-ubuntu.md 与 installing-git-arch.md一个 GitHub 账号第一步安装并登录 GitHub CLI首先在你的系统中安装github-cli工具即gh命令行工具。安装完成后执行登录命令gh auth login按照交互提示完成认证即可。登录后gh会获得访问你 GitHub 账号的权限后续的 fork、创建 PR 等操作都不需要再打开浏览器手动操作。第二步Fork 仓库——一条命令完成Fork复制上游仓库到你的账号下只需要一条命令gh repo fork firstcontributions/first-contributions重要提示命令执行过程中会询问你是否需要同时克隆仓库到本地请选择yes这样 fork 与 clone 一步到位。这也是gh repo fork相比在网页上手动点 Fork 按钮README.md 中的常规方式的最大优势整个流程无需离开终端。如果你在后续步骤中选择了不同答案也可以随时用常规命令补充克隆例如git clone gitgithub.com:你的用户名/first-contributions.git第三步创建你的专属分支接下来用 Git 创建分支。分支命名建议采用add-你的名字的形式例如你的名字是 taras-shevchenkogit switch -c add-taras-shevchenko其中-c表示 create即创建并切换到新分支。如果你使用的 Git 版本较老、不支持git switch可以用等价命令git checkout -b add-taras-shevchenko。第四步修改文件并提交在文本编辑器中打开仓库根目录下的 Contributors.md 文件把你的名字加到文件中建议加在文件中间任意位置而不是文件开头或结尾然后保存。回到项目目录执行git status你会看到工作区中已被修改的文件。接下来把改动加入暂存区并提交git add Contributors.mdgit commit -m Add taras-shevchenko to Contributors list提交信息中的taras-shevchenko请替换为你的实际名字。第五步推送分支到 GitHub将你的分支推送到远端即你在第二步 fork 出来的仓库git push origin -u your-branch-name把your-branch-name替换为你在第三步创建的分支名。-u即--set-upstream用于建立本地分支与远端分支的跟踪关系之后再次推送只需执行git push。推送报错身份验证失败怎么办如果你在推送时看到类似下面的错误remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for https://github.com/your-username/first-contributions.git/这说明 GitHub 已经不再接受用账号密码进行 Git 操作认证该变更自 2021 年 8 月起生效。解决办法是为你的 GitHub 账号配置 SSH 密钥并改用 SSH 协议推送。本仓库的 storing-credentials.md 对凭据存储方式有更详细的说明配置好 SSH 密钥后还可以用以下命令检查并修正远端地址git remote -v git remote set-url origin gitgithub.com:你的用户名/first-contributions.git第六步用 gh 创建 Pull Request在仓库目录下执行下面的命令gh会基于当前分支与上游仓库firstcontributions/first-contributions自动生成 Pull Requestgh pr create --repo firstcontributions/first-contributions按提示填写标题与描述后提交即可。之后你随时可以用下面的命令查看 PR 状态gh statusgh status会列出与你当前账号相关的 PR 及其检查状态让你在终端中就能追踪 PR 的全生命周期这也是 CLI 工作流相比网页操作的便利之处。接下来可以做什么恭喜你刚刚完整走过了开源贡献的标准流程fork → clone → edit → pull request这正是你日后参与任何开源项目都会反复遇到的协作模式。同步 fork随着项目持续演进你的 fork 会逐渐落后于上游。此时可以参考 keeping-your-fork-synced-with-this-repository.md 学习三角工作流通过git remote add upstream、git fetch upstream、git rebase upstream/main、git push origin main让本地与 fork 保持最新。进阶 Git 技巧本仓库还整理了 amending-a-commit.md修改最近一次提交、squashing-commits.md合并提交、resolving-merge-conflicts.md解决合并冲突、reverting-a-commit.md撤销已推送的提交等实战文档入口见 additional-material.md。尝试其他工具如果你之后想体验图形化流程仓库还提供了 GitHub Desktop、VS Code、GitKraken、Sourcetree 等工具的教程见 README.md 的教程列表也可以在 docs/translations/README.zh-cn.md 查看中文版主教程。现在带上这套全终端工作流去为更多开源项目贡献你的力量吧。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考