需先初始化本地仓库(git init),再添加文件到暂存区(git add),提交变更(git commit),关联远程仓库(git remote add origin),最后推送至github(git push -u origin main)。

如果您已完成本地代码开发,希望将其上传至 GitHub 仓库进行版本管理与协作,则需通过 Git 命令行将本地仓库与远程仓库建立关联并推送提交。以下是完成该操作的完整流程:
一、初始化本地 Git 仓库
若当前项目目录尚未被 Git 跟踪,需先将其转化为 Git 仓库,以便记录版本变更和后续推送。
1、打开终端(macOS/Linux)或命令提示符/PowerShell(Windows),进入您的项目根目录。
2、执行命令:git init,初始化空 Git 仓库。
3、运行 git status 确认工作区状态,查看未跟踪文件列表。
二、添加文件到暂存区
Git 不会自动追踪所有文件,需显式声明哪些文件纳入版本控制范围,此过程称为“暂存”。
1、将全部文件加入暂存区:执行 git add .(注意末尾英文句点)。
2、如仅添加特定文件,例如 README.md 和 src/main.py,则运行:git add README.md src/main.py。
3、再次使用 git status 验证文件已显示为“要提交的变更”。
三、提交更改到本地仓库
暂存区中的文件需通过提交生成快照,形成可回溯的版本节点,这是推送前必需的本地操作。
1、执行命令:git commit -m "初始提交",引号内为本次提交的简明描述。
2、描述应准确反映改动内容,例如:git commit -m "添加用户登录接口及单元测试"。
3、提交成功后,终端将显示类似“1 file changed, 10 insertions(+)”的统计信息。
四、关联远程 GitHub 仓库
本地仓库需绑定一个远程地址,才能将提交同步至 GitHub;该地址可在 GitHub 新建仓库页面获取。
1、在 GitHub 网站创建新仓库(无需初始化 README 或 .gitignore),复制其 HTTPS 或 SSH 地址。
2、在本地项目目录中运行:git remote add origin https://github.com/用户名/仓库名.git。
3、验证是否成功添加远程源:git remote -v,应显示 origin 对应的 fetch/push URL。
五、推送代码至 GitHub
完成上述步骤后,本地提交即可传输至远程仓库,使代码在 GitHub 上可见并支持协作。
1、首次推送主分支时,执行:git push -u origin main(GitHub 默认主分支名为 main)。
2、若本地默认分支为 master,且远程仓库也使用 master,则改用:git push -u origin master。
3、推送成功后,终端将显示类似“remote: Create a pull request for 'main' on GitHub”提示,并列出已更新的引用。
六、处理推送拒绝(非快进)情况
当远程仓库存在本地没有的提交(如他人已推送),直接 push 将被拒绝,需先整合远程变更。
1、运行:git pull origin main --rebase,拉取远程提交并变基到本地提交之后。
2、若出现冲突,需手动编辑标有 git add . 再继续变基:git rebase --continue。
3、变基完成后,重新执行:git push origin main(此时无需 -u 参数)。










