将若依(RuoYi)项目创建为私有Gitee仓库的完整步骤
方法一:直接上传到新仓库(推荐新手)
下载若依源码
访问官方仓库:https://gitee.com/y_project/RuoYi
点击右侧绿色按钮「克隆/下载」→「下载ZIP」
解压到本地文件夹
创建Gitee仓库
登录Gitee → 点击右上角「+」→「新建仓库」
填写仓库信息:
仓库名称:your-ruoyi (自定义)
勾选 私有仓库
取消勾选 “使用Readme文件初始化仓库”(重要!)
其他保持默认 → 点击「创建」
上传源码到仓库
# 进入解压后的若依项目目录
cd RuoYi# 初始化本地仓库
git init
git add .
git commit -m "首次提交:若依初始版本"# 关联Gitee远程仓库
git remote add origin https://gitee.com/你的用户名/your-ruoyi.git# 推送代码
git push -u origin master
第一步:清理原有 Git 记录(重要!)
# 进入项目根目录(包含 pom.xml 的目录)
cd ruoyi-project# 删除原有的 .git 文件夹(这会清除所有历史记录)
rm -rf .git # macOS/Linux# Windows 使用:
del /F /Q /S .git 2>nul
rd /s /q .git
第二步:初始化新仓库
git init
第三步:关联你自己的远程仓库
在 Gitee 创建空仓库
登录 Gitee → 右上角 ➕ → 新建仓库
仓库名:如 my-ruoyi-project
不勾选 “使用 Readme 文件初始化”
关联远程仓库
git remote add origin git@gitee.com:你的Gitee用户名/仓库名.git
# 示例:
git remote add origin git@gitee.com:john/my-ruoyi-project.git
第四步:提交所有代码
# 添加所有文件到暂存区(注意后面有个点)
git add .# 提交初始版本
git commit -m "init: 基于若依框架初始化项目"
第五步:推送到远程仓库
# 首次推送需要设置上游分支
git push -u origin master# 若使用 main 分支(新仓库默认分支)
git branch -M main && git push -u origin main
第六步:验证推送结果
刷新 Gitee 仓库页面,应看到所有代码
本地查看远程关联
git remote -v
# 显示:
# origin git@gitee.com:john/my-ruoyi-project.git (fetch)
# origin git@gitee.com:john/my-ruoyi-project.git (push)
第七步:修改项目标识(可选但推荐)
更新项目信息,将其真正变成你自己的项目:
# 1. 修改项目名称(pom.xml)
sed -i 's/<name>ruoyi/<name>my-project/g' pom.xml# 2. 修改包名(需IDE操作)
# 将 com.ruoyi 全局替换为 com.你的公司名
# 示例:com.mycompany# 3. 更新登录页标题
# 文件路径:ruoyi-ui/src/index.html
# 修改 <title>若依管理系统</title> 为自己的名称# 4. 更新版权信息
# 文件:ruoyi-admin/src/main/resources/logback.xml
# 搜索 "若依" 替换为你的项目名
配置建议(优化仓库管理)
# 1. 创建 .gitignore 文件(若没有)
cat > .gitignore <<EOF
# Maven 忽略
target/
*.war
*.ear# 前端忽略
ruoyi-ui/node_modules/
ruoyi-ui/dist/# IDE
.idea/
*.iml# 日志
*.log
logs/
EOF# 2. 提交忽略文件
git add .gitignore
git commit -m "chore: add .gitignore"# 3. 永久保存账号密码(避免重复输入)
git config --global credential.helper store
问题:
pc@DESKTOP-7CUAM24 MINGW64 /d/project/RuoYi-Vue-master/RuoYi-Vue-master (main)
$ git push -f origin master
error: src refspec master does not match any
error: failed to push some refs to 'gitee.com:yang_hai_long0000/YHLwebsite'
问题原因分析
你的本地分支是 main,但尝试推送到远程的 master 分支
远程仓库可能不存在 master 分支(Gitee新仓库默认分支为 main)
解决方案(任选其一)
方案1:推送本地main分支到远程main分支
git push -u origin main
方案2:重命名本地分支为master再推送
git branch -m main master
git push -u origin master
方案3:强制创建远程master分支
git push origin main:master --force
方案4:修改远程默认分支(推荐)
在Gitee仓库设置中:
进入仓库 → 管理 → 分支管理
将默认分支改为 main
然后执行:
git push -u origin main
git branch -vv
# 应显示类似:
# * main a1b2c3d [origin/main] commit message
pc@DESKTOP-7CUAM24 MINGW64 /d/project/RuoYi-Vue-master/RuoYi-Vue-master (master)
$ git branch
* masterpc@DESKTOP-7CUAM24 MINGW64 /d/project/RuoYi-Vue-master/RuoYi-Vue-master (master)
$ git push -u origin master
[session-b048a3aa] Auth error: 404 not found!
fatal: Could not read from remote repository.Please make sure you have t
根据错误信息,这是典型的远程仓库认证失败问题。以下是完整的解决方案:
首先确认远程仓库是否存在:
登录Gitee网站检查 yang_hai_long0000/YHLwebsite 仓库是否存在
如果不存在,需要先在Gitee创建空仓库
检查当前远程仓库配置:
git remote -v
推荐使用SSH协议(需提前配置SSH密钥):
git remote set-url origin git@gitee.com:yang_hai_long0000/YHLwebsite.git
如果必须使用HTTPS协议,配置凭证存储:
git config --global credential.helper store
最后重新推送:
git push -u origin master
问题
pc@DESKTOP-7CUAM24 MINGW64 /d/project/RuoYi-Vue-master/RuoYi-Vue-master (master)
$ git remote -v
origin git@gitee.com:yang_hai_long0000/YHLwebsite.git (fetch)
origin git@gitee.com:yang_hai_long0000/YHLwebsite.git (push)
https://gitee.com/yang_hai_long0000/yhlwebsite
当前远程仓库配置显示两种协议混用:
SSH协议:git@gitee.com/YHLwebsite.git
HTTPS协议:https://gitee.com/yang_hai_long0000/yhlwebsite
注意URL大小写不一致:“YHLwebsite” vs “yhlwebsite”
解决方案
第一步:统一远程仓库协议(推荐SSH)
# 移除现有远程仓库配置
git remote remove origin# 重新添加SSH协议的远程仓库(注意保持大小写一致)
git remote add origin git@gitee.com:yang_hai_long0000/YHLwebsite.git
第二步:验证SSH连接
ssh -T git@gitee.com
# 成功应显示:Hello yang_hai_long0000! You've successfully authenticated...
第三步:强制推送代码
git push -f origin master