1️⃣ 初始化本地项目为 Git 仓库

如果你的项目还没用 Git 管理，先在项目目录下初始化：

git init

2️⃣ 添加 GitHub 远程仓库

通过命令添加远程仓库：

git remote add origin <Github url>

如果执行后 git remote -v 发现有多个远程仓库，例如：

origin          https://github.com/liyao52033/vitepress-teek.git (fetch)
origin          https://github.com/liyao52033/vitepress-teek.git (push)
vitepress-teek  https://github.com/liyao52033/vitepress-teek.git (fetch)
vitepress-teek  https://github.com/liyao52033/vitepress-teek.git (push)

删除多余的远程仓库：

git remote remove vitepress-teek

再次检查：

git remote -v

输出应为：

origin  https://github.com/liyao52033/vitepress-teek.git (fetch)
origin  https://github.com/liyao52033/vitepress-teek.git (push)

3️⃣ 解决本地文件与远程文件冲突

如果想要 上传本地代码覆盖 GitHub

1. 提交本地代码：

   git add .
   git commit -m "本地代码首次提交"
   

2. 强制推送覆盖远程：

   git push -u origin main --force
   

如果想要 用 GitHub 代码覆盖本地

1. 拉取远程代码：

从远程仓库（origin）下载最新的分支、提交和标签，但 不会修改你当前的工作区和本地分支。

git fetch origin

把当前分支（通常是 main）的指针重置到远程分支 origin/main 的最新提交，并且强制同步工作区和暂存区。

git reset --hard origin/main

删除工作目录中所有 未跟踪的文件和文件夹（即不在 Git 管理中的文件）。

git clean -fd

如果想要 保留两边代码，合并

1. 创建临时分支拉取远程：

   git fetch origin
   git checkout -b temp-branch origin/main // 基于远程分支 origin/main 创建一个新的本地分支 temp-branch，并切换到它。
   

2. 切回本地分支：

   git checkout main //切换回已有的本地分支 main
   

3. 合并：

   git merge temp-branch
   

4. 解决冲突后提交：

   git add .
   git commit -m "合并远程与本地代码"
   git push -u origin main
   

4️⃣ 在 VS Code 中可视化操作（可选）

​ 添加 GitHub 远程仓库如下

• 打开 VS Code ，如果没初始化 Git，点击左侧的源代码管理图标（或按下Ctrl + Shift + G），点击初始化存储库按钮。
• 点击右上角 … → 远程 → 添加远程存储库 → 填写 仓库 URL，远程名称填 origin
• 点击同步按钮（⟳）即可推送代码

---

✅ 常用命令汇总

# 查看所有远程仓库
git remote -v

# 删除多余的远程
git remote remove <name>

# 添加远程
git remote add origin <repo-url>

# 提交本地代码
git add .
git commit -m "message"

# 推送代码到远程
git push -u origin main

# 强制覆盖远程
git push -u origin main --force

# 用远程覆盖本地
git fetch origin
git reset --hard origin/main
git clean -fd

💡 推荐做法： 如果你的本地代码是最终要保留的，可以直接用 上传覆盖 GitHub（强推）； 如果只是想拉取远程代码，用 覆盖本地 即可。