本地文件上传到gitee仓库的详细步骤
本地文件上传到gitee仓库的详细步骤
🔰 一、前期准备注册 Gitee 账号访问 Gitee 官网完成注册并登录。
网址：https://gitee.com/
安装 Git下载 Git 官方客户端并完成安装。
下载网址：https://git-scm.com/downloads
配置 Git 全局信息（首次使用需设置）
git config --global user.name “你的用户名”
git config --global user.email “你的邮箱”
🛠️ 二、操作步骤1. 在 Gitee 创建仓库登录 Gitee → 点击右上角 +→ 选择 新建仓库。
填写仓库名称（如 my-project）、描述，选择公开/私有。
关键选项：初始化仓库：不勾选 使用README文件初始化仓库（避免后续冲突）。
忽略文件：按需添加 .gitignore模板（如 Java/Python）。
点击 创建，生成空仓库
- 初始化本地仓库
进入项目根目录cd /path/to/your/project
初始化 Git 仓库git init
添加所有文件到暂存区git add .
提交到本地仓库git commit -m “Initial commit”
- 关联远程仓库
复制 Gitee 仓库的 HTTPS 地址（格式：https://gitee.com/用户名/仓库名.git）git remote add origin https://gitee.com/your_username/your_repo.git
- 推送到 Gitee
首次推送（注意分支名）git push -u origin master # Git < 2.28 版本git push -u origin main # Git ≥ 2.28 版本
输入 Gitee 账号密码 或 个人访问令牌（若启用两步验证需用令牌替代密码）注意：如果报错类似如下错To https://gitee.com/miraclechq/food-app.git ! [rejected] master -> master (non-fast-forward)error: failed to push some refs to 'https://gitee.com/miraclechq/food-app.git’hint: Updates were rejected because a pushed branch tip is behind its remotehint: counterpart. If you want to integrate the remote changes, use 'git pull’hint: before pushing again.hint: See the ‘Note about fast-forwards’ in ‘git push --help’ for details.
这个错误表明你的本地master分支落后于远程仓库的master分支，导致推送被拒绝。
以下是解决方案：
同步远程更改 git pull origin master
这会拉取远程仓库的最新更改并与本地合并
解决冲突后执行：git add .git commit -m “解决冲突”
重新推送：git push origin master1
特殊情况处理：若远程有初始化文件(如README)而本地没有 ，若确定要覆盖远程更改(谨慎使用)：git pull origin master --allow-unrelated-historiesgit push -f origin master
- 验证结果刷新 Gitee 仓库页面，确认文件已成功同步
⚠️ 三、关键注意事项分支名称问题Git 2.28+ 默认分支为 main，低版本为 master。
若推送失败，检查远程仓库默认分支名并调整命令认证方式
选择HTTPS：需每次输入密码（或配置凭证缓存）。SSH（推荐）：通过公钥免密推送（需提前 配置 SSH 密钥）。
忽略文件配置在项目根目录创建 .gitignore文件，列出需忽略的文件（如 node_modules/, .log），避免提交无效文件。
4.冲突解决若远程有初始化文件（如 README），需先拉取合并：git pull origin master --allow-unrelated-histories # 强制合并不相关历史# 解决冲突后重新提交推送
❓ 四、常见问题解决fatal: refusing to merge unrelated histories**添加 --allow-unrelated-histories参数合并。
错误：remote: Incorrect username or password
检查密码或令牌是否正确
git credential-manager reject # Windows
git credential-osxkeychain erase # macOS
rm ~/.git-credentials # Linux
大文件上传失败增大 Git 缓冲区：
git config --global http.postBuffer 524288000 # 500MB
💡 总结完成上述步骤后，本地文件即成功同步至 Gitee。
后续更新代码只需：git add .git commit -m “更新描述”
git push
保持提交信息清晰，定期拉取远程更新，可高效管理代码版本