Git版本提交助手

## Git 提交命令

```bash
# 1) 切换到目标分支（分支已存在时）
git switch feature/login

# 如果本地不存在该分支，可先拉取远端再创建并切换：
# git fetch origin
# git switch -c feature/login origin/feature/login

# 2) 查看变更（可选）
git status

# 3) 暂存指定文件（按你的输入：当前目录所有变更）
git add .

# 4) 提交
git commit -m "fix(ui): 修复登录按钮点击无效"
```

## 操作说明
- 第一步确保在目标分支 feature/login 上进行提交，避免把更改提交到错误分支。
- 提交前用 git status 检查待提交文件是否符合预期。
- 使用 git add . 暂存当前目录下所有变更（新增/修改/删除），然后执行 commit。
- 提交信息已符合 Conventional Commits 规范，无需调整。

## 注意事项
- git add . 会把当前目录及子目录所有变更都加入暂存，请确认没有无关文件；必要时先调整 .gitignore。
- 若你在仓库子目录执行并且需要捕获仓库任意位置的删除变更，可改用 git add -A。
- 如果仓库配置了 pre-commit/pre-push 等钩子，提交可能会因校验失败而中止，请按提示修复后重试。
- 需要推送到远端时再执行：git push -u origin feature/login（可选）。

## 提交命令（目标分支：release/1.2.0，提交路径：src/auth/）

```bash
# 1) 确保本地有最新远端分支信息
git fetch origin

# 2) 切到目标分支（本地已存在该分支时）
git switch release/1.2.0

# 若本地不存在该分支，可改用（从远端跟踪创建）：
# git switch -c release/1.2.0 --track origin/release/1.2.0

# 3) 拉取最新提交，避免产生不必要的合并提交
git pull --ff-only

# 4) 仅暂存指定目录的改动
git add src/auth/

# 5) 可选：核对将要提交的内容
git status --short
git diff --staged

# 6) 按规范提交
git commit -m 'feat(auth): 增加短信登录入口; refs: ADR-12'

# 7) 可选：推送到远端
git push origin release/1.2.0
```

## 操作说明与注意事项
- 请确保已切换到正确的目标分支 release/1.2.0，并先拉取最新代码（使用 --ff-only 避免产生合并提交）。
- 使用 git add 只对 src/auth/ 下的变更进行暂存，避免把无关改动带入本次提交。若需精确控制，可用 git add -p 分块添加。
- 提交前用 git status 和 git diff --staged 再次核对将要提交的文件和差异。
- 提交信息已符合 Conventional Commits 格式：feat(scope): subject；包含引用 refs: ADR-12。若你的仓库有校验钩子，请保持格式一致。
- 如需代码评审或 CI，请在提交后执行 git push origin release/1.2.0，并按照团队流程创建合并请求。

## 提交命令

```bash
# 1) 切换到目标分支（本地已存在该分支）
git switch hotfix/1023

# 2) 查看当前工作区状态（可选，确认只改动了预期文件）
git status --short

# 3) 仅添加指定文件到暂存区
git add -- tests/e2e/login.spec.ts

# 4) 按给定信息提交
git commit -m 'test(e2e): 补充 #1023 回归用例'

# 5) 可选：推送到远端
git push -u origin hotfix/1023
```

## 操作说明与注意事项
- 如果本地没有该分支：
  - 远端已存在同名分支时：`git switch -c hotfix/1023 --track origin/hotfix/1023`
  - 远端不存在同名分支时：`git switch -c hotfix/1023`
- 提交信息已使用引号包裹，`#1023` 会被正确保存（在大多数平台会自动关联到对应 issue/任务）。
- 为避免误加其他文件，建议在 `git add` 前先执行 `git status` 确认变更列表。
- 如不小心多加了文件，可用 `git restore --staged <文件路径>` 撤回暂存，不会影响工作区改动。
- 若你的环境是 Windows CMD（非 PowerShell/WSL），请将提交信息的引号改为双引号：`git commit -m "test(e2e): 补充 #1023 回归用例"`。
- 若项目启用了 commitlint/Husky 等钩子，请确保提交信息格式与规范一致（当前信息已符合 Conventional Commits 风格）。