需依次执行五步:一、git init 初始化本地仓库;二、git remote add origin 关联 github 远程地址;三、git add . 和 git commit -m 提交初始代码;四、git branch -m main 与 git push -u origin main 推送至远程;五、https 方式失败时用 pat 替代密码认证。

如果您在本地创建了一个新项目,希望将其上传到 GitHub 进行版本管理与协作,则需要完成初始化本地仓库、关联远程仓库、提交代码并推送等操作。以下是具体执行步骤:
一、初始化本地 Git 仓库
在项目根目录中创建 Git 版本控制所需的元数据目录(.git),使该文件夹成为可追踪变更的本地仓库。
1、打开终端(macOS/Linux)或命令提示符/PowerShell(Windows)。
2、使用 cd 命令切换至您的项目根目录,例如:cd /path/to/your/project。
3、执行命令:git init。
二、添加远程 GitHub 仓库地址
将本地仓库与 GitHub 上新建的空仓库建立连接,以便后续推送代码。
1、登录 GitHub 网站,点击右上角 “+” 号,选择 “New repository”。
2、填写仓库名称,保持 “Initialize this repository with a README” 处于未勾选状态(避免冲突),点击 “Create repository”。
3、在新仓库页面,复制顶部显示的远程地址(HTTPS 或 SSH 格式,推荐 HTTPS)。
4、在终端中执行:git remote add origin https://github.com/username/repository-name.git(将链接替换为实际地址)。
三、暂存并提交本地文件
将待上传的文件纳入 Git 暂存区,并生成一次本地版本快照,为推送做准备。
1、执行命令:git add .(将当前目录下所有未忽略文件加入暂存区)。
2、执行命令:git status,确认待提交文件列表无误。
3、执行命令:git commit -m "Initial commit"(引号内为本次提交的简要说明)。
四、推送到 GitHub 远程仓库
将本地提交的历史记录同步至 GitHub 对应的远程分支,完成首次上传。
1、确认当前所在分支为 main 或 master(多数新仓库默认为 main)。
2、执行命令:git branch -M main(如当前分支名非 main,强制重命名为 main)。
3、执行命令:git push -u origin main(-u 参数建立上游跟踪,后续推送可简化为 git push)。
五、处理常见身份验证问题
GitHub 自 2021 年起不再支持密码方式提交,需通过个人访问令牌(PAT)或 SSH 密钥认证。
1、若使用 HTTPS 方式推送失败,访问 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token。
2、勾选 repo 权限,生成后复制该令牌。
3、再次执行 git push 时,用户名填写 GitHub 账户名,密码栏粘贴该令牌。










