需先初始化本地仓库、关联远程仓库、提交并推送代码；https方式推送失败时需配置personal access token，ssh方式则需生成密钥并添加公钥。

如果您已安装 GitHub Desktop 并希望将本地项目上传至 GitHub 远程仓库，则需完成初始化仓库、关联远程地址及推送代码等操作。以下是具体执行步骤：

一、初始化本地仓库

GitHub Desktop 无法直接提交未纳入 Git 版本控制的文件夹，因此需先将项目目录识别为 Git 仓库。该步骤会在项目根目录生成 .git 文件夹，启用版本追踪能力。

1、打开 GitHub Desktop 应用程序。

2、点击左上角 File → Add Local Repository…。

3、在弹出窗口中点击 Choose…，浏览并选中您的项目文件夹。

4、确认路径无误后点击 Add Repository。

二、关联远程 GitHub 仓库

若尚未在 GitHub 网站创建对应仓库，GitHub Desktop 可自动为您新建；若已有远程仓库，则需手动添加其 HTTPS 或 SSH 地址。此步骤建立本地与远程仓库的映射关系。

1、在 GitHub Desktop 主界面右上角点击 Publish repository 按钮（若仓库未发布）。

2、在弹出窗口中输入仓库名称、描述（可选）、选择公开性（Public/Private）。

3、勾选 Keep this code private（仅限 GitHub Pro 用户或私有仓库权限可用）。

4、点击 Publish repository，GitHub Desktop 将自动创建远程仓库并完成关联。

三、提交并推送代码

提交（Commit）是将暂存区的更改保存为一个版本快照；推送（Push）是将本地提交同步至远程仓库。二者不可互换，必须先提交再推送。

1、在 GitHub Desktop 左侧文件列表中，勾选需纳入本次提交的所有变更文件。

2、在下方输入框中填写 Summary（简要说明），建议使用英文动词开头，如 “add login page” 或 “fix typo in README”。

Github Xiaoshu

使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。

下载

3、点击 Commit to main（或当前分支名）按钮。

4、提交完成后，点击右上角 Push origin 按钮，将本次提交上传至 GitHub 远程仓库。

四、处理未授权错误（HTTPS 方式常见）

当使用 HTTPS 地址关联远程仓库且未配置凭据时，推送可能因认证失败中断。GitHub Desktop 默认调用系统凭据管理器，但 Windows 或 macOS 若未正确存储 token，将触发拒绝访问提示。

1、访问 https://github.com/settings/tokens，点击 Generate new token → Generate new token (classic)。

2、勾选 repo 和 workflow 权限，其他保持默认。

3、点击 Generate token，复制生成的十六进制字符串。

4、在 GitHub Desktop 中进入 File → Options → Accounts，点击 Update credentials，粘贴该 token 替代密码。

五、使用 SSH 替代 HTTPS（免密推送方案）

SSH 协议通过密钥对实现免密码验证，避免频繁输入账户凭证，同时提升安全性。需提前在本地生成密钥并在 GitHub 账户中添加公钥。

1、打开终端（macOS/Linux）或 Git Bash（Windows），执行：ssh-keygen -t ed25519 -C "your_email@example.com"。

2、连续按回车使用默认路径和空密码短语。

3、运行：cat ~/.ssh/id_ed25519.pub，复制输出的全部内容。

4、访问 https://github.com/settings/ssh-and-gpg-keys，点击 New SSH key，粘贴并保存。

5、在 GitHub Desktop 中，进入仓库设置 → Repository → Repository Settings → Remote，将 URL 改为以 git@github.com:username/repo-name.git 格式的 SSH 地址。