# 1. 进入项目目录，初始化仓库
cd my-project
git init

# 2. 添加所有文件并首次提交
git add .
git commit -m "feat: 初始化项目，添加基础结构"

# 3. 在 GitHub/GitLab 上创建空仓库，然后关联远程
git remote add origin https://github.com/yourname/my-project.git

# 4. 推送本地主分支到远程（首次需设置上游）
git push -u origin main

# 1. 基于主分支创建功能分支
git checkout main
git pull origin main   # 确保主分支最新
git checkout -b feat-add-login

# 2. 开发代码，多次提交
echo "login code" > login.py
git add login.py
git commit -m "feat: 实现用户名密码登录接口"

# 3. 推送到远程功能分支（用于备份或协作）
git push origin feat-add-login

# 4. 切换回主分支，合并功能分支
git checkout main
git merge feat-add-login --no-ff   # --no-ff 保留分支历史

# 5. 删除已合并的本地分支和远程分支
git branch -d feat-add-login
git push origin --delete feat-add-login

# 1. 从主分支创建 hotfix 分支
git checkout main
git checkout -b hotfix-login-error

# 2. 修复问题并提交
echo "fixed" >> login.py
git commit -am "fix: 修复用户名密码校验为空时的空指针异常"

# 3. 合并回主分支并打标签
git checkout main
git merge hotfix-login-error
git tag -a v1.0.1 -m "紧急修复登录空指针问题"
git push origin main --tags

# 4. 删除 hotfix 分支
git branch -d hotfix-login-error

# 场景：提交了两次，发现最后一次提交有问题
git log --oneline
# a1b2c3d (HEAD) fix: 修改配置文件
# e4f5g6h feat: 添加缓存功能

# 方法1：撤销最后一次提交，但保留修改（推荐）
git reset --soft HEAD~1
git status   # 修改仍保留在暂存区

# 方法2：彻底丢弃最后一次提交的修改（慎用）
git reset --hard HEAD~1

# 正在开发新功能，突然需要紧急修 bug
git status   # 有未提交的修改
git stash save "未完成的新功能代码"
git checkout main
git checkout -b hotfix-critical

# 修复 bug 并提交、合并后...
git checkout feat-new-function
git stash pop   # 恢复之前未完成的工作

# 当前在 feat-dashboard 分支
git status   # 确保工作区干净

# 方法1：使用 merge（保留合并提交）
git fetch origin
git merge origin/main

# 方法2：使用 rebase（历史更线性，推荐）
git fetch origin
git rebase origin/main
# 如果有冲突，解决后执行 git rebase --continue

# 查看简洁日志，找到目标提交的哈希
git log --oneline

# 查看该提交的完整改动
git show a1b2c3d

# 只查看该提交修改了哪些文件
git show --name-only a1b2c3d

# 1. 查看远程仓库地址
git remote -v
# origin  https://github.com/yourname/project.git (fetch)
# origin  https://github.com/yourname/project.git (push)

# 2. 尝试普通推送（会被拒绝）
git push origin feat-dashboard
# error: failed to push some refs to '...'

# 3. 【不推荐】强制推送（直接覆盖，不管远程是否有新提交）
git push --force origin feat-dashboard

# 4. 【推荐】更安全的强制推送（如果远程分支被他人更新过，会拒绝推送）
git push --force-with-lease origin feat-dashboard

# 普通删除（要求分支已合并）
git push origin --delete feat-obsolete
# error: remote branch 'feat-obsolete' is not fully merged

# 强制删除（忽略未合并警告）
git push --force --delete origin feat-obsolete
# 或使用更直接的命令
git push origin :feat-obsolete --force

# 1. 先查看状态（确认本地修改确实可丢弃）
git status
# Changes not staged for commit: modified: config.yaml

# 2. 强制覆盖本地（⚠️ 不可恢复）
git fetch origin main
git reset --hard origin/main
git clean -fd   # 删除未跟踪的文件和目录

# 普通变基拉取（遇冲突会暂停）
git pull --rebase origin main

# 【危险】强制变基拉取：遇到冲突时自动使用远程版本
git pull --rebase -X theirs origin main
# -X theirs 表示冲突时选择远程版本

# 远程分支 main 从 commit B 回退到了 commit A
# 本地执行普通 fetch：
git fetch origin
git log origin/main   # 仍然显示 commit B（旧的引用）

# 强制 fetch 覆盖本地远程跟踪分支：
git fetch --force origin main
# 或等价写法
git fetch origin +refs/heads/main:refs/remotes/origin/main

# 验证
git log origin/main   # 现在显示 commit A（正确的）

# 普通 prune fetch
git fetch --prune origin

# 强制版本（更彻底）
git fetch --prune --force origin

# 查看效果
git branch -r   # 远程已删除的分支不再显示

# 强制推送（覆盖远程）
git push --force-with-lease origin <branch>   # 推荐
git push --force origin <branch>              # 不推荐

# 强制删除远程分支
git push --force --delete origin <branch>

# 强制覆盖本地工作区（丢弃所有未提交修改）
git fetch origin <branch>
git reset --hard origin/<branch>
git clean -fd

# 强制清理远程引用
git fetch --prune --force origin

# 强制变基拉取（冲突时使用远程版本）
git pull --rebase -X theirs origin <branch>