需完成初始化、关联远程仓库、暂存、提交与推送等标准 git 操作:一、git init 初始化本地仓库;二、git remote add origin [url] 关联 github 远程地址;三、git add . 暂存全部文件;四、git commit -m "初始提交" 提交更改;五、git push -u origin main 推送至远程;六、使用 pat 或 ssh 解决认证问题。

如果您已完成本地代码开发,希望将代码同步到 GitHub 远程仓库,则需完成初始化、关联远程仓库、暂存、提交与推送等标准 Git 操作流程。以下是上传代码到 GitHub 的完整操作步骤:
一、创建并初始化本地 Git 仓库
初始化本地目录为 Git 仓库,是后续所有版本控制操作的前提。该操作会在项目根目录生成 .git 隐藏文件夹,用于记录版本历史。
1、打开终端(macOS/Linux)或命令提示符/PowerShell(Windows),使用 cd 命令进入您的代码所在文件夹。
2、执行命令:git init。
3、运行 git status 查看当前仓库状态,确认已成功初始化。
二、添加远程 GitHub 仓库地址
将本地仓库与 GitHub 上新建的空仓库建立连接,使本地提交可被推送到指定远程位置。此步骤需提前在 GitHub 网站创建新仓库并复制其 HTTPS 或 SSH 地址。
1、在 GitHub 页面创建新仓库,不勾选 “Initialize this repository with a README”,点击 “Create repository”。
2、复制页面上方显示的仓库地址(以 https://github.com/用户名/仓库名.git 或 git@github.com:用户名/仓库名.git 形式)。
3、在本地终端中执行:git remote add origin [复制的仓库地址]。
4、验证是否添加成功:运行 git remote -v,应显示 origin 对应的 fetch 和 push 地址。
三、暂存待提交的文件
Git 提交前必须先将修改的文件加入暂存区(Staging Area),以明确本次提交包含哪些变更。未暂存的文件不会被提交。
1、查看未跟踪和已修改的文件:执行 git status。
2、暂存单个文件:git add 文件名(例如 git add index.html)。
3、暂存全部更改(含新增、修改、删除):git add .(注意末尾有英文句点)。
四、提交暂存的更改
将暂存区中的文件快照永久保存至本地仓库的历史记录中,并附带描述性提交信息,便于后续追溯。
1、执行命令:git commit -m "初始提交"(引号内替换为具体、简洁的中文或英文说明)。
2、如需修改上一次提交信息(未推送前),可使用:git commit --amend -m "修正后的提交信息"。
五、推送代码到 GitHub 远程仓库
将本地提交的历史同步至 GitHub 远程仓库,使代码对外可见并支持协作。首次推送需指定分支名称及上游跟踪关系。
1、确认当前分支名:运行 git branch --show-current(常见为 main 或 master)。
2、推送本地 main 分支到远程 origin 的 main 分支:git push -u origin main(若默认分支为 master,则将 main 替换为 master)。
3、后续推送只需执行:git push。
六、处理常见身份认证问题
GitHub 自 2021 年 8 月起不再支持密码方式提交,必须使用 Personal Access Token(PAT)或 SSH 密钥进行身份验证,否则推送会失败并提示“Authentication failed”。
1、生成 PAT:登录 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token → 勾选 repo 权限 → Generate token → 复制生成的令牌。
2、推送时用户名填写 GitHub 账户名,密码栏粘贴该令牌(非账户密码)。
3、为避免重复输入,可配置 Git 凭据存储:git config --global credential.helper store,随后首次推送时输入一次即可缓存。
七、使用 SSH 方式替代 HTTPS 推送
SSH 协议无需每次输入令牌,且更安全。需预先在本地生成密钥对,并将公钥添加至 GitHub 账户设置中。
1、检查是否已有 SSH 密钥:ls -al ~/.ssh/id_rsa.pub。
2、如无,生成新密钥:ssh-keygen -t ed25519 -C "your_email@example.com",按回车接受默认路径。
3、启动 SSH 代理并添加密钥:eval "$(ssh-agent -s)",然后执行 ssh-add ~/.ssh/id_rsa(或对应私钥路径)。
4、复制公钥内容:cat ~/.ssh/id_rsa.pub,前往 GitHub Settings → SSH and GPG keys → New SSH key → 粘贴并保存。
5、将远程 URL 改为 SSH 格式:git remote set-url origin git@github.com:用户名/仓库名.git。










