将若依(RuoYi)项目创建为私有Gitee仓库的完整步骤

方法一:直接上传到新仓库(推荐新手)

‌下载若依源码‌

访问官方仓库:https://gitee.com/y_project/RuoYi

点击右侧绿色按钮「克隆/下载」→「下载ZIP」

解压到本地文件夹

‌创建Gitee仓库‌

登录Gitee → 点击右上角「+」→「新建仓库」

填写仓库信息:

仓库名称:your-ruoyi (自定义)

勾选 ‌私有仓库‌

‌取消勾选‌ "使用Readme文件初始化仓库"(重要!)

其他保持默认 → 点击「创建」

‌上传源码到仓库

bash 复制代码
# 进入解压后的若依项目目录
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 记录(重要!)

bash 复制代码
# 进入项目根目录(包含 pom.xml 的目录)
cd ruoyi-project

# 删除原有的 .git 文件夹(这会清除所有历史记录)
rm -rf .git  # macOS/Linux

# Windows 使用:
del /F /Q /S .git 2>nul
rd /s /q .git

第二步:初始化新仓库

bash 复制代码
git init

第三步:关联你自己的远程仓库

‌在 Gitee 创建空仓库‌

登录 Gitee → 右上角 ➕ → 新建仓库

仓库名:如 my-ruoyi-project

不勾选 "使用 Readme 文件初始化"

‌关联远程仓库

bash 复制代码
git remote add origin git@gitee.com:你的Gitee用户名/仓库名.git
# 示例:
git remote add origin git@gitee.com:john/my-ruoyi-project.git

第四步:提交所有代码

bash 复制代码
# 添加所有文件到暂存区(注意后面有个点)
git add .

# 提交初始版本
git commit -m "init: 基于若依框架初始化项目"

第五步:推送到远程仓库

bash 复制代码
# 首次推送需要设置上游分支
git push -u origin master

# 若使用 main 分支(新仓库默认分支)
git branch -M main && git push -u origin main

第六步:验证推送结果

刷新 Gitee 仓库页面,应看到所有代码

本地查看远程关联

bash 复制代码
git remote -v
# 显示:
# origin  git@gitee.com:john/my-ruoyi-project.git (fetch)
# origin  git@gitee.com:john/my-ruoyi-project.git (push)

第七步:修改项目标识(可选但推荐)

更新项目信息,将其真正变成你自己的项目:

bash 复制代码
# 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
#    搜索 "若依" 替换为你的项目名

配置建议(优化仓库管理)

bash 复制代码
# 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

问题:

bash 复制代码
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分支

bash 复制代码
git push -u origin main

方案2:重命名本地分支为master再推送

bash 复制代码
git branch -m main master
git push -u origin master

方案3:强制创建远程master分支

bash 复制代码
git push origin main:master --force

方案4:修改远程默认分支(推荐)

在Gitee仓库设置中:

进入仓库 → 管理 → 分支管理

将默认分支改为 main

然后执行:

bash 复制代码
git push -u origin main
bash 复制代码
git branch -vv
# 应显示类似:
# * main a1b2c3d [origin/main] commit message
bash 复制代码
pc@DESKTOP-7CUAM24 MINGW64 /d/project/RuoYi-Vue-master/RuoYi-Vue-master (master)
$ git branch
* master

pc@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创建空仓库

检查当前远程仓库配置:

bash 复制代码
git remote -v

推荐使用SSH协议(需提前配置SSH密钥):

bash 复制代码
git remote set-url origin git@gitee.com:yang_hai_long0000/YHLwebsite.git

如果必须使用HTTPS协议,配置凭证存储:

bash 复制代码
git config --global credential.helper store

最后重新推送:

bash 复制代码
git push -u origin master

问题

bash 复制代码
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)

bash 复制代码
# 移除现有远程仓库配置
git remote remove origin

# 重新添加SSH协议的远程仓库(注意保持大小写一致)
git remote add origin git@gitee.com:yang_hai_long0000/YHLwebsite.git

第二步:验证SSH连接

bash 复制代码
ssh -T git@gitee.com
# 成功应显示:Hello yang_hai_long0000! You've successfully authenticated...

第三步:强制推送代码

bash 复制代码
git push -f origin master
相关推荐
ps_xiaowang4 小时前
React Query入门指南:简化React应用中的数据获取
前端·其他·react native·react.js
知识分享小能手4 小时前
微信小程序入门学习教程,从入门到精通,微信小程序开发进阶(7)
前端·javascript·学习·程序人生·微信小程序·小程序·vue3
sophie旭5 小时前
一道面试题,开始性能优化之旅(8)-- 构建工具和性能
前端·面试·性能优化
市民中心的蟋蟀5 小时前
第三章 钩入React 【上】
前端·react.js·架构
Holin_浩霖6 小时前
为什么typeof null 返回 "object" ?
前端
PanZonghui6 小时前
Zustand 实战指南:从基础到高级,构建类型安全的状态管理
前端·react.js
PanZonghui6 小时前
Vite 构建优化实战:从配置到落地的全方位性能提升指南
前端·react.js·vite
_extraordinary_7 小时前
Java Linux --- 基本命令,部署Java web程序到线上访问
java·linux·前端
用户1456775610377 小时前
推荐一个我私藏的电脑神器:小巧、无广、功能强到离谱
前端