本地项目第一次推送到gitee上的完整命令

步骤	核心命令	关键说明
1. 本地初始化	git init	在项目根目录执行，创建本地 Git 仓库。
2. 关联远程仓库	git remote add origin <仓库URL>	将本地仓库与 Gitee 上的远程仓库建立连接。
3. 文件添加到暂存区	git add .	准备所有文件进行提交。也可指定具体文件。
4. 提交到本地仓库	git commit -m "提交说明"	将暂存区的文件正式保存到本地仓库历史中。
5. 推送到 Gitee	git push -u origin master	将本地提交推送到 Gitee。-u 参数设置上游分支。

一、详细操作指南

1. 前期准备

• 安装与配置 Git ：确保本地已安装 Git，并配置全局用户信息：

  git config --global user.name "你的Gitee用户名"
  git config --global user.email "你的Gitee绑定邮箱"

• 创建 Gitee 远程仓库 ：在 Gitee 官网新建一个空仓库，创建时建议不要勾选"使用 README 文件初始化仓库"等选项，以避免首次推送时的冲突。

2. 执行推送命令 打开终端（或 Git Bash），进入你的项目根目录，然后顺序执行以下命令

注意：根据你的 Git 版本和 Gitee 仓库的默认分支设置，主分支名称可能是 master 或 main。如果上述命令失败，请尝试将 master 替换为 main

3、常见问题与解决

• 推送被拒绝（非快进冲突） ：如果远程仓库（例如不小心初始化了 README 文件）已有本地没有的提交历史，直接 push 会被拒绝

  。

  • 解决方案 ：先执行 git pull origin master --allow-unrelated-histories 拉取远程更改并合并历史，解决可能的冲突后再次推送。如果确定要覆盖远程内容（慎用 ），可使用 git push -f 强制推送。

• 认证失败 ：推送时可能需要输入 Gitee 的用户名和密码。如果你开启了两步验证，需要使用个人访问令牌（Token）代替密码

  。

• 大文件上传失败 ：如果项目较大，可能会因默认缓冲区大小限制而失败。可以尝试增大 Git 的 postBuffer 设置

  git config --global http.postBuffer 524288000

4、实用建议

• 使用 SSH 免密推送 ：为避免每次推送都输入密码，强烈建议配置 SSH 密钥 进行认证。完成后，远程仓库地址应使用 SSH 格式（如 git@gitee.com:用户名/仓库名.git）。
• 利用 .gitignore 文件 ：在项目根目录创建 .gitignore 文件，列出不希望被提交到仓库的文件或目录（如 build/, .idea/, *.log 等），可以保持仓库清洁。

完成这些步骤后，你的本地项目就成功推送到 Gitee 了。之后若需更新代码，只需执行 git add .、git commit -m "更新说明" 和 git push 这三步即可。