| 步骤 | 核心命令 | 关键说明 |
|---|---|---|
| 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，并配置全局用户信息：
javagit 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设置javagit 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 这三步即可。