用途:在需要创建 git 提交、把变更拆分成多个提交或撰写提交信息时使用。核心理念是提交尽可能小,方便审查。
主要能力与流程: 先了解现状,运行 git status --short、git diff --stat、git diff、git log --oneline -n 20;必要时用 git log --oneline -- <path> 查看特定路径历史。 拆分:一个提交只关注一件事。不相关的改动要分开;diff 感觉过大就继续拆;除非极小且不可分割,否则不把重构与行为变更混在一起;无关工作保持未暂存。 暂存:优先使用显式路径 git add path/to/file,避免在脏工作区用 git add . 和 git commit -a;暂存过多可用 git restore --staged <path> 撤销;用 git diff --cached --stat 与 git diff --cached 审查确切提交内容。 排除:绝不提交被 gitignore 的文件;不提交日志、缓存、临时输出、构建产物、本地环境文件、编辑器垃圾、下载文件等临时文件;不确定时用 git check-ignore -v <path> 检查;看起来是生成或仅本地使用的文件,除非用户明确要求,否则不纳入。 提交信息:先推断近期提交的惯例,路径历史风格清晰时优先参考;风格混杂或不明确时默认使用 conventional commits。主题简短、具体、用祈使句、末尾不加句号。安全默认如 feat(scope): add x、fix(scope): handle y、refactor(scope): simplify z、docs(scope): update w、chore(scope): clean up q。 提交:只提交已审查的切片;提交后用 git show --stat --oneline HEAD 验证;若没有干净且连贯的内容可提交,应如实说明而不是强行提交。
适用场景:日常开发中编写规范、可审查的提交历史,尤其适合希望按关注点拆分变更的仓库。
限制:资料未提供安装方式、平台支持、收费与许可等信息,也未说明与具体工具或模型的集成细节。