将若依(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 创建空仓库‌

仓库名：如 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