Leonurus-free

在二次开发的基础上拉去官方项目合并

🔧 场景说明：

你 fork 或 clone 的开源项目在 GitHub 上有更新；
你对自己 fork 的版本做了修改（即二次开发）；
现在想将官方项目的新内容合并到你的版本中，尽量保留你自己的修改。

✅ 操作步骤：

初始化项目

git init

第一步：添加上游（官方）仓库作为远程源

如果还没添加过：

git remote add upstream https://github.com/原作者名/原项目名.git

可以验证远程仓库：

git remote -v

第二步：从上游拉取最新的代码

先切换到你的主分支（比如 main 或 master）：

git checkout main

拉取上游的更新：

git fetch upstream

第三步：合并上游分支到你本地的主分支

git merge upstream/main

（注意，如果对方项目是 master 分支，就替换成 upstream/master）

这一步可能会出现冲突，如果有冲突，手动解决它们，然后执行：

git commit

第四步：将合并后的内容推送到你自己的 GitHub 仓库

git push origin main

⚠️ 提示：

建议在合并之前先创建一个备份分支：
```
git checkout -b backup-before-merge
```
如果你对原项目改动很大，建议先对比哪些文件/模块改动较少，先小范围合并。

🧠 可选方案：用 `rebase` 代替 `merge`（更干净的提交历史）

如果你熟悉 Git，也可以用：

bash


复制编辑
git rebase upstream/main

但要注意解决冲突的顺序性。

创建并推送新分支

如果你想在本地创建新分支并同步到远程仓库，按以下步骤操作：

1. 创建并切换到新分支

git checkout -b custom

注：该命令等同于 git branch custom + git checkout custom。

2. 将新分支推送到远程仓库并建立关联

git push -u origin custom

注：-u (或 --set-upstream) 会将本地分支与远程分支关联，之后只需执行 git push 即可。

常用 Git 维护操作

1. 撤销与修补 (Undo & Fix)

修补上一次提交 (不产生新记录):

git commit --amend -m "修正后的提交信息"

撤销提交，保留代码修改:
```
git reset --soft HEAD~1
```
强制回退到某个版本 (慎用，会丢失修改):
```
git reset --hard <commit_id>
```
放弃单个文件的修改:
```
git checkout -- <file_path>
```

2. 暂存修改 (Stash)

藏起当前的修改:
```
git stash
```
恢复并删除最近一次暂存:
```
git stash pop
```

3. 查看历史与状态

图形化查看精简日志:
```
git log --oneline --graph --all
```
查看文件每一行的作者 (找锅神器):
```
git blame <file_path>
```

4. 远程分支清理

清理远程已删除但本地仍存在的分支指针:
```
git remote prune origin
```

强制用远程代码覆盖本地:

git fetch --all && git reset --hard origin/main

更换 Git 远程仓库地址

更换 Git 远程仓库地址是一个非常常见的操作。你可以根据你的具体需求，选择以下几种方法之一：

方法一：修改现有的远程仓库地址（最推荐）

如果你只是想更新当前远程仓库（通常名为 origin）的 URL，这是最直接的方法。

打开终端或命令行工具，进入你的项目根目录。
输入以下命令：
```
git remote set-url origin <新仓库地址>
```
将 <新仓库地址> 替换为你的 SSH 或 HTTPS 链接（例如 https://github.com/user/repo.git）。
验证修改是否成功：
```
git remote -v
```
如果列出的地址是你的新地址，说明修改成功了。

方法二：先删除再添加

如果你希望操作逻辑更清晰，或者想顺便更改远程仓库的别名，可以使用这个方法。

删除现有的远程连接：
```
git remote remove origin
```

添加新的远程仓库地址：

git remote add origin <新仓库地址>

推送到新仓库：如果你是第一次推送到这个新地址，建议指定上游分支：
```
git push -u origin main
```
（注：如果你的主分支名是 master，请将 main 改为 master）

方法三：直接修改配置文件（进阶）

如果你不习惯使用命令行，也可以直接编辑项目中的配置文件。

进入项目根目录下的 .git 文件夹（这是一个隐藏文件夹）。
找到并打开名为 config 的文件。
找到 [remote "origin"] 这一行，修改其下方的 url = ... 为你的新地址。
保存并退出即可。

注意事项

权限问题：如果你从 HTTPS 切换到 SSH 地址，请确保你已经在新的托管平台（如 GitHub/GitLab）中配置好了 SSH Key。
新旧仓库内容同步：如果新仓库是一个完全空的仓库，你可能需要运行 git push -u origin --all 将所有本地分支推送到新地址，以及 git push origin --tags 推送所有标签。
分支名称对应：确保新仓库的默认分支名称（如 main 或 master）与你本地的分支习惯一致，避免推送失败。