一、问题/场景描述
许多开发者在本地完成代码编写后，需要将代码上传到 GitHub 进行版本管理和协作。但新手常遇到提交失败、权限错误或分支混乱等问题。本文详细讲解如何通过 Git 命令将本地代码正确提交到 GitHub 仓库，确保流程顺畅。
二、原因分析
提交失败通常由以下原因引起：一是本地未正确初始化 Git 仓库或未关联远程仓库；二是 SSH 密钥未配置导致认证失败；三是分支名称不匹配或本地有未提交的修改。Git 提交本质是将本地版本库的更改推送到远程服务器，必须按顺序完成初始化、暂存、提交和推送四个步骤。忽略任一环节都会导致错误。
三、详细解决步骤
步骤1：初始化本地仓库
首先在项目根目录打开终端，执行以下命令创建一个新的 Git 仓库：
git init此命令会在当前目录生成一个隐藏的 .git 文件夹，用于存储版本历史。
步骤2：添加文件到暂存区
将需要提交的代码文件添加到暂存区。添加单个文件：
git add index.html添加所有文件（排除 .gitignore 中列出的文件）：
git add .步骤3：提交到本地仓库
将暂存区的更改提交到本地仓库，并附上描述信息：
git commit -m "初始化项目，添加首页文件"提交信息应简洁明了，说明本次更改的内容。
步骤4：关联远程GitHub仓库
在 GitHub 上创建一个新仓库（不要勾选初始化 README），然后复制仓库的 SSH 或 HTTPS 地址。在本地执行：
git remote add origin [email protected]:用户名/仓库名.git请将地址替换为你的实际仓库地址。SSH 方式需提前配置 SSH 密钥。
步骤5：推送到GitHub
将本地代码推送到远程仓库的主分支（通常为 main 或 master）。首次推送使用：
git push -u origin main如果远程仓库已有文件（如 README.md），需先拉取合并：
git pull origin main --allow-unrelated-histories然后再次执行推送命令。推送成功后，在 GitHub 仓库页面即可看到代码。
四、注意事项
确保已安装 Git 并配置好用户名和邮箱：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"使用 SSH 方式需先生成并添加公钥到 GitHub 设置。避免将敏感文件（如 .env、密码文件）提交到仓库，应添加到 .gitignore 中。推送前建议先执行 git status 确认状态。
五、适用环境
本文适用于主流操作系统（Windows、macOS、Linux）上安装的 Git 2.x 版本，配合 GitHub 网站使用。