GitHub Desktop 10分钟上手教程：新手第一次提交、分支与推送一次讲清

2026/10/30 2:23:05

GitHub Desktop 10分钟上手教程：新手第一次提交、分支与推送一次讲清

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

GitHub Desktop 是官方开源免费的 Git 图形化客户端，把命令行变成点选界面，克隆、提交、分支、发起 Pull Request 都能用鼠标完成。适合想管理 GitHub 仓库、但一条git命令都不想背的新手。当前稳定版 3.6.10 已内置 Git，装完即用，跟着走大约 10 分钟能走完"安装 → 克隆 → 提交 → 推送"全程。

先花30秒确认你走哪条路

Windows 用户，还没装过→ 走 Windows 上10分钟完成首次推送
macOS 用户→ 走 macOS 上把 Desktop 跑起来
本地已有仓库，只想接管→ 走把现成的本地仓库接进来
中途报错卡住→ 直接跳卡住了怎么办

Windows 上10分钟完成首次推送

开始前：确认3件事

拿到官方安装器GitHubDesktopSetup.exe（装给当前用户；想让整台电脑共用就选.msi），安装细节见 docs/installation.md
手里有一个 GitHub 账号，首次启动会要求登录
本地已经有一个要管理的文件，或准备从 GitHub 克隆仓库

最短路径：5步装好并推出去

双击安装器一路下一步，装完启动。首次启动弹出 GitHub 登录页，授权后凭据会存进系统，后面不用再输。
顶部菜单File → Clone repository，粘贴仓库地址，选一个保存位置，点克隆。
打开仓库后随便改一个文件，左侧Changes面板会立刻列出它——这就是你"待提交"的清单。
在面板顶部文本框写一句提交说明，勾选那个文件，点Commit to main（main 会显示你当前分支名）。
点顶栏Push origin，本地改动就上了远端。

验证与兜底：看到什么才算成

顶栏分支旁显示main up to date with origin/main，说明本地和远端已对齐，收工。点 Push 没反应或报错，先看登录状态（右上角头像），再跳到卡住了怎么办。

macOS 上把 Desktop 跑起来

开始前

下载GitHub Desktop.zip，解压后把 app 拖进 Applications 文件夹
系统要求 macOS 10.9 及以上；数据目录在~/Library/Application Support/GitHub Desktop/

最短路径

启动 → 登录 GitHub →File → Clone repository，后面和 Windows 流程完全一样：改文件、Commit、Push，一共 3 次点击搞定提交。

验证与兜底

应用能打开、顶栏有分支名就算跑起来了。如果升级时提示临时目录权限错误，按 docs/known-issues.md 里 macOS 一节的步骤给com.github.GitHubClient.ShipIt加"读写"权限。

把现成的本地仓库接进来

开始前

本地文件夹已是 Git 仓库（能看到隐藏的.git子文件夹；没有的话先在那目录终端里跑一句git init）
Desktop 已安装并登录

最短路径

File → Add local repository，选中文件夹，打开即可。左上角切分支、右侧看改动，体验和克隆的仓库一模一样。

验证与兜底

顶栏出现分支名和领先/落后数字说明接管成功。如果仓库还没配远端，Push 按钮不会出现——先在终端执行git remote add origin <仓库地址>，再回来看按钮。

卡住了怎么办

遇到推送前提示先拉取（Your push was rejected / need to pull）：远端有新提交了。按界面提示点Pull origin，合并完再 Push 一次，别强推。
遇到 Authentication failed 或反复要密码：Windows 打开"凭据管理器"清掉过期的 GitHub 条目再登录；macOS 打开钥匙串访问，把login钥匙串锁定再解锁，重新登录一次。两种写法都在 docs/known-issues.md 里有对应小节。
遇到 Pull 后顶部红色 CONFLICT 横幅：说明两边改了同一处。点横幅进入冲突解决视图，逐文件选"保留哪一边"，确认后再提交即可。
遇到 Windows 启动后黑屏：部分显卡不支持硬件加速。PowerShell 里执行$env:GITHUB_DESKTOP_DISABLE_HARDWARE_ACCELERATION=1后再启动。
遇到公司网络的证书校验报错（schannel 相关）：先看 docs/known-issues.md Windows 一节的证书与注册表条目两条，按场景处理，别盲目全局改 Git 配置。

Desktop 就是个把点击翻译成 git 命令的前台。以上 3 条路走通后，日常提交、切分支、看差异都不再需要终端；rebase、stash、PR 评审这些进阶功能，可以从 README.md 和 docs/ 继续往下钻。

关键入口：