需先初始化本地仓库、关联远程仓库、提交并推送代码；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”。
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 地址。
