创建好git项目仓库后如何将本地项目传上去

前端备忘录2025-10-13 16:14

将本地项目上传至Gitee仓库的核心步骤如下：

1. 初始化本地仓库

在项目根目录右键打开Git Bash或终端，执行git init命令初始化本地Git仓库，此时会生成隐藏的.git文件夹

复制代码

git init

2. 关联远程仓库

使用git remote add origin <仓库地址>命令关联Gitee远程仓库，地址可在Gitee仓库页面的"克隆/下载"按钮处获取（HTTPS或SSH格式）例如：

复制代码

git remote add origin https://gitee.com/yourname/repo.git

3. 添加文件到暂存区

通过git add .添加所有文件到暂存区（或指定文件名/文件夹），注意命令中的空格和点符号

复制代码

git add .

4. 提交文件到本地仓库

执行git commit -m "提交说明"，提交说明需简洁明确，例如"初始提交"

复制代码

git commit -m "提交说明"

5. 解决可能的冲突

若远程仓库已存在README等文件，需先执行git pull origin master --allow-unrelated-histories合并历史记录，避免推送失败

复制代码

git pull origin master --allow-unrelated-histories

6. 推送至远程仓库

使用git push -u origin master推送代码到Gitee主分支（若使用其他分支需替换master为目标分支名）首次推送需输入Gitee账号密码验证。

复制代码

git push -u origin master

常见问题处理

推送被拒绝‌：检查远程仓库是否有未合并的更改，或尝试强制推送git push -f origin master（慎用）
大文件上传失败‌：Gitee限制单文件不超过500MB，需拆分文件或使用Git LFS
身份验证失败‌：确保Git全局配置的用户名和邮箱与Gitee账号一致，可通过git config --global user.name/email设置

完整流程示例

复制代码

git init
git remote add origin https://gitee.com/yourname/repo.git
git add .
git commit -m "initial commit"
git pull origin master --allow-unrelated-histories
git push -u origin master