企业官网建设流程全解析

从克隆仓库到推送第一个提交：GitHub Desktop新手工作流完整教程

【免费下载链接】desktopFocus on what matters instead of fighting with Git.项目地址: https://gitcode.com/gh_mirrors/de/desktop

GitHub Desktop 是一款图形化 Git 客户端，让你不用敲任何命令行，就能完成克隆仓库、查看差异、提交代码、推送提交的完整工作流。本教程面向新手，用 5 个步骤带你走通 GitHub Desktop 新手工作流：从克隆一个仓库开始，修改文件、撰写你的第一个提交，最后把它推送到 GitHub 远端。全程无需记忆任何 Git 命令，适合刚接触版本控制的同学快速上手。

认识 GitHub Desktop 主界面：Changes 与 History 两个标签

打开 GitHub Desktop 并进入任意仓库后，你会看到主界面被分成左右两部分：左侧是提交列表与分支切换器，右侧是Changes（变更）和History（历史）两个标签页。所有日常操作——查看差异、提交、推送——都围绕这两个区域展开。

顶部工具栏集中了最常用的动作：当前分支下拉、Pull（拉取）、Publish repository（发布仓库）等按钮。推送相关逻辑实现在 push-pull-button.tsx 中，它会随仓库状态自动切换为 Push 或 Pull 的可用形态。

一键克隆仓库：从 GitHub 或任意 URL 开始

克隆是把远端仓库完整复制到本地的第一步。点击左侧边栏的仓库图标，选择New repository（新建仓库），即可打开克隆对话框。该对话框的源码位于 clone-repository.tsx。

方式一：克隆 GitHub 上的仓库

选择GitHub repository标签页，登录后会列出你有权限访问的所有仓库，支持搜索、按项目分组，选中后直接点击Clone即可。整个选择列表由 clone-github-repository.tsx 渲染。

方式二：通过通用地址克隆

选择Generic repository标签页，粘贴任意 Git 仓库的 URL（HTTPS 或 SSH 地址均可），再在Local path中指定本地保存位置。这个入口由 clone-generic-repository.tsx 实现，适合克隆 GitLab、Bitbucket 或其他 Git 服务器的仓库。

💡 小贴士：本地路径默认保存在你的用户目录下，建议为每个项目单独建一个文件夹，方便管理。

查看未提交更改：Changes 标签页详解

修改仓库中的任意文件（比如往仓库根目录添加一张图片），回到 GitHub Desktop 的Changes标签页，左侧文件列表会立刻列出所有变动的文件。点击某个文件，右侧会显示逐行的红绿差异对比，新增内容标绿、删除内容标红，一目了然。

变更列表的筛选与多选逻辑在 filter-changes-logic.ts 中实现；如果你一次改动了很多文件，可以只勾选其中一部分进行提交。

撰写并创建你的第一个提交：Commit 到当前分支

在 Changes 标签页中，每个变动文件前都有一个勾选框。勾选你打算提交的文件后，填写提交信息：

1. 标题行（Summary）：一句话概括改动，例如Add demo image
2. 详细说明（Description，可选）：补充背景或动机

然后按分支选择器旁的Commit to main按钮（分支名会跟随当前分支自动变化）。提交成功后，变更从左侧 Changes 列表移入 History 列表，表示改动已安全地记录到本地仓库。提交区域的 UI 定义在 changes.tsx。

⚠️ 建议：提交信息用英文或清晰的短句开头，动词开头（Add / Fix / Update），以后在 History 里回看会轻松很多。

发布仓库并推送第一个提交：Publish 与 Push

如果仓库有远端（例如你刚才克隆的仓库），工具栏会显示Push按钮，点击后所有未推送的提交会立即上传到远端。

如果是本地新建的仓库（还没有远端），工具栏会显示Publish repository按钮：

• 填写仓库名、选择公开或私有，确认后即可把整个本地仓库（连同你的第一个提交）一次性创建并推送到 GitHub
• 发布流程的界面由 publish-repository.tsx 实现，核心逻辑在 app-store.ts 的_publishRepository方法中
• 发布完成后，工具栏的 Publish 按钮会变为 Push，之后的每次提交都能一键推送

推送状态的三个小图标

每次 Push 之后，工具栏会用箭头图标告诉你本地分支与远端的差距：↑1表示有 1 个提交待推送，↓2表示远端有 2 个新提交需要 Pull。看到↑0 ↓0就说明本地与远端完全同步，可以放心了。

新手常见问题：推送被拒绝怎么办？

Q：点击 Push 后提示「The push was rejected」，是什么意思？A：最常见的原因是远端在你上次拉取之后又有了新提交（比如队友推了新代码）。解决办法很简单：先点Pull把远端更新合并下来，如果有冲突，GitHub Desktop 会引导你逐文件解决，处理完再次 Push 即可。

Q：可以撤销刚才的提交吗？A：可以。在 History 标签页中找到该提交，点击右侧的Undo（撤销提交），改动会原样放回 Changes 列表，文件内容不会丢失。

Q：如何创建功能分支再合并？A：点击工具栏的分支下拉菜单选择Create branch，在新分支上提交后，切回主分支再选择合并即可，全程有图形化引导，无需记忆 rebase/merge 命令。

延伸阅读

• 安装与环境配置：docs/installation.md
• 各平台搭建指南：docs/contributing/setup.md
• 新建本地仓库界面：create-repository.tsx
• 拉取/推送按钮交互：push-pull-button-dropdown.tsx
• 文档总入口：docs/README.md

恭喜！🎉 到这里，你已经完成了 GitHub Desktop 新手工作流的核心闭环：克隆仓库 → 查看差异 → 第一个提交 → 发布并推送。接下来可以试试创建一个新分支，体验分支开发的工作流。

【免费下载链接】desktopFocus on what matters instead of fighting with Git.项目地址: https://gitcode.com/gh_mirrors/de/desktop