文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载导读本文基于 first-contributions 仓库的 VS Code 德语图形化教程对应英文原版 github-windows-vs-code-tutorial.md整理而成面向不熟悉命令行、希望用图形界面完成人生第一次开源贡献的初学者。读完本文你将能在 VS Code 内全程可视化地完成Fork → Clone → Branch → Edit → Commit → Push → Pull Request这一开源贡献标准工作流并理解每一步背后的 Git 原理以及它与主 README 命令行教程的对应关系。为什么选择图形界面完成首次贡献第一次参与开源协作往往令人紧张——在团队协作中犯错并不愉快但开源的本质正是协作与共同工作。阅读文章、观看视频教程固然有帮助但没有什么比亲自动手实践更有价值。first-contributions 项目项目主说明的目标就是为新手提供引导让他们在不会搞砸任何东西的安全环境中完成第一次贡献其核心理念是你越放松学得越好。对于不熟悉终端操作的读者README 提供了一批基于 GUI 工具的教程入口而本文就是其中的 VS Code 方案——全程不需要手敲git命令所有操作都在 VS Code 的图形界面中完成同时每一步都会映射到对应的 Git 底层操作让你在动手的同时建立正确的 Git 心智模型。教程环境说明本教程基于 Windows 10 机器上的 Visual Studio Code 1.27.2 版本制作。文中使用的键盘快捷键可能因操作系统macOS/Linux和键盘语言UK、DE 等而有所不同你可以随时在 VS Code 的命令面板Command Palette中搜索 shortcut 查看完整的快捷键列表。第一步Fork 这个仓库建立你的工作副本打开 first-contributions 仓库页面点击页面右上角的Fork按钮GitHub 就会在你的账户中创建该仓库的一份完整副本。这里需要理解 Fork 背后的协作模型GitHub 会持续跟踪你的仓库与你 Fork 的来源仓库之间的上下游关系你可以把自己的 Fork 视为一份工作副本working copy。绝大多数 GitHub 顶级仓库即没有从其他仓库 Fork 而来的仓库只有一个小规模核心团队拥有直接提交commit权限所有其他贡献者都必须先 Fork 仓库在自己的 Fork 中做出修改然后通过Pull RequestPR请求将修改合并回顶级仓库如果顶级仓库的管理员认可这些修改它们就会被合并。主 README 的命令行流程与本文 GUI 流程在第一步上是完全一致的无论走哪条路线你都需要先 Fork 出属于自己的仓库副本。第二步Clone 你的仓库下载到本机2.1 复制你自己的仓库地址Fork 完成后下一步是把你自己的 Fork而不是原始仓库克隆到本机这样才能开始修改。在你的 Fork 仓库页面上点击绿色的Code按钮点击复制到剪贴板copy to clipboard图标将仓库 URL 复制下来。⚠️ 新手高频错误很多新手犯的错误是克隆了Fork 的来源仓库而不是自己 Fork 的仓库。请务必检查浏览器地址栏确认你正在克隆的是你自己的仓库。原教程也强调务必克隆 Fork 后的仓库而不是原仓库否则后续操作无法进行。作为对照README 命令行流程中对应的命令是git clone 你刚复制的url例如git clone gitgithub.com:你的用户名/first-contributions.git。而在 GUI 流程中这一切都在 VS Code 内完成不需要打开终端。2.2 在 VS Code 中执行克隆打开 Visual Studio Code会先出现欢迎页Welcome page按下F1打开命令面板Command Palette可以看到输入框中已自动带有一个大于号提示符你也可以按CTRL-P进入输入提示符后手动输入字符输入git clone实际上只需要输入git或clone即可命令面板的工作方式类似搜索在结果中选择Git: Clone条目并按Enter粘贴你刚才复制的仓库 URL按EnterVS Code 会打开文件资源管理器让你选择这个 Git 仓库在本机的存放位置完成后VS Code 右下角会出现状态提示克隆结束后可以通过对话框中的按钮直接打开这个已克隆的仓库此时它已经是本机的一个文件夹。说明命令面板中可能已经列出一些看似陌生的命令那只是你或系统最近使用过的命令记录可以完全忽略。第三步创建分支Branch并理解 checkout在 VS Code 中再次按F1打开命令面板输入branch从结果中选择create branch命令输入你的新分支名称例如add-david-kroell按Enter确认。分支创建后会被自动检出checked out这意味着你当前所处的就是新分支后续的修改都会落在这个分支上而不会污染主分支。从 Git 原理看这一步骤对应 README 中的命令行操作git switch -c add-alonzo-church # 创建并切换分支如果你的 Git 版本较旧、不支持git switch可以使用等价的git checkout -b 你的新分支名。为什么一定要开新分支在协作中每个功能/修复都应在独立分支上进行这样既能隔离变更、便于审查也能让同一个 Fork 同时承载多个互不干扰的贡献这正是后续 Pull Request 能够按分支提交的基础。第四步做出必要的修改编辑 Contributors.md接下来修改仓库根目录下的 Contributors.md 文件在 VS Code 中打开Contributors.md不要在文件的开头或结尾添加你的名字而是复制文件中间某一位已有贡献者的行把它改成你的名字例如- [你的名字](https://github.com/你的用户名)确保 Markdown 语法正确——GFMGitHub Flavored Markdown的语法比较挑剔复制已有行是最稳妥的做法保存文件以登记修改。关于这份文件可以从仓库内容得到两个事实该文件就是本仓库所有贡献者的名单目前已有数千行、超过 5000 条贡献记录格式统一为- 名字的列表项这正是复制一行再修改方法可行的原因原教程明确指出该文件包含GFMGitHub Flavored Markdown它是 Markdown 语法的一种专有变体。对应到 README 命令行教程此步骤的 Git 语义是编辑文件后用git status查看变更用git add Contributors.md将文件加入暂存区staging area。第五步Commit 并 Push 到 GitHub5.1 暂存与提交Staging Commit在 VS Code 左侧边栏有 5 个图标的菜单中选择**版本控制/源代码管理Source Control**图标快捷键为Ctrl Shift G文件资源管理器会列出自上次提交以来所有被修改的文件将鼠标悬停在文件上点击加号即可将文件暂存staged——这一步对应命令行中的git add在资源管理器顶部输入提交信息原教程建议填写类似Add your-name to Contributors list的描述然后点击对勾✓按钮修改即被提交到你的本地副本——对应命令行中的git commit -m Add your-name to Contributors list参见 README。5.2 发布分支Publish Branch修改已提交到本地但还没有回到 GitHub 上。此时点击 VS Code 顶部的三点⋯菜单选择Publish Branch选项——它会将当前分支推送到远程对应命令行中的git push -u origin 你的分支名-u参数会同时把本地分支与远程分支建立跟踪关联参见 READMEVS Code 会弹出对话框要求输入你的 GitHub 凭据credentials完成认证。认证提示如果你使用的是 HTTPS 克隆方式且遇到认证失败可以参考 README 中的排错说明自 2021 年 8 月 13 日起 GitHub 已移除密码认证需改用 personal access token 或 SSH 密钥也可以用git remote -v检查远程地址必要时用git remote set-url origin gitgithub.com:用户名/仓库.git切换到 SSH 方式。不过通过 VS Code 的 Publish Branch 流程通常会走 GitHub 的 OAuth 浏览器授权比手配 SSH 简单得多。第六步提交 Pull RequestPR请求合并至此你的修改已经完整地存在于你自己的仓库中但还没有进入顶级仓库。PR 正是向顶级仓库管理员申请合并的正式渠道回到 GitHub 上你的 Fork 仓库页面在新分支的提示横幅旁边你会看到Compare pull request按钮点击它确认比较基准base 为上游仓库的主分支compare 为你的新分支后提交submit这个 Pull Request。提交后仓库维护者会审查你的修改通过后将其合并进主分支并在合并完成后通过邮件通知你。这一点在主 README 中也有明确说明提交 PR 的完整流程。回顾你刚刚完成的完整工作流恭喜你刚刚走完了开源贡献者最常遇到的标准工作流Fork复制仓库→ Clone克隆到本机→ Branch创建分支→ Edit修改→ Commit本地提交→ Push推送到远程→ Pull Request申请合并这个流程不仅是 first-contributions 的练习路径也是你今后参与几乎所有 GitHub 开源项目时都会反复使用的协作模式。以下是 GUI 操作与 Git 命令的完整对应表方便你建立两种操作方式的心智映射阶段VS Code 图形操作等价的 Git 命令见 READMEForkGitHub 网页点击 Fork—GitHub 服务端操作Clone命令面板Git: Clonegit clone url建分支命令面板create branchgit switch -c name旧版 Git 用git checkout -b name暂存源码管理面板点击git add Contributors.md提交填写提交信息点 ✓git commit -m Add your-name to Contributors list推送三点菜单Publish Branchgit push -u origin branch提 PRGitHub 点击Compare pull request—GitHub 网页操作进阶接下来可以做什么完成首次贡献后你可以在本仓库的附加材料Additional material中继续学习更多常用的进阶 Git 技巧包括修改amend最近一次提交——修正提交信息或补充遗漏的文件保持 Fork 与上游仓库同步——当上游仓库有新提交时让你的 Fork 保持最新解决合并冲突merge conflicts——PR 合并时最常见的拦路虎压缩提交squashing commits——当审查者要求把多个提交合并为一个时使用配置 Gitconfiguring git、撤销本地提交、删除分支 等。此外仓库还提供了覆盖其他工具的图形化教程参见 README 的 Tutorials Using Other Tools 部分GitHub Desktop、GitKraken、Sourcetree、IntelliJ IDEA 等以及面向终端的命令行教程与 GitHub CLI 教程你可以根据自己的工具偏好选择下一步的学习路线。赞分享文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载相关推荐使用 Visual Studio Code 完成第一次开源贡献first-contributions 图形化实战指南使用 Visual Studio Code 完成第一次开源贡献first contributions 图形化实战指南 本篇指南以开源教学仓库 first co文档教程开源治理使用 Sublime Merge 完成首次开源贡献first-contributions 图形化实战指南使用 Sublime Merge 完成首次开源贡献first contributions 图形化实战指南 导读 本文基于 first contribution文档教程开源治理first-contributions 项目实战使用 Visual Studio Code 完成你的第一次开源贡献first contributions 项目实战使用 Visual Studio Code 完成你的第一次开源贡献 本指南基于 first contribut文档教程开源治理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考