59 lines
14 KiB
JavaScript
59 lines
14 KiB
JavaScript
import{_ as a,o as i,c as n,a2 as t}from"./chunks/framework.B-QBKwc1.js";const r=JSON.parse('{"title":"Git 提交规范","description":"统一的 Git 提交规范有助于代码审查、版本管理和自动化工具集成。","frontmatter":{},"headers":[],"relativePath":"zh/standards/git.md","filePath":"zh/standards/git.md"}'),e={name:"zh/standards/git.md"};function p(l,s,d,h,o,c){return i(),n("div",null,[...s[0]||(s[0]=[t(`<h1 id="_12-3-Git-提交规范" tabindex="-1">12.3 Git 提交规范 <a class="header-anchor" href="#_12-3-Git-提交规范" aria-label="Permalink to "12.3 Git 提交规范""></a></h1><div class="tip custom-block"><p class="custom-block-title">概述</p><p>统一的 Git 提交规范有助于代码审查、版本管理和自动化工具集成。</p></div><h2 id="Commit-Message-格式" tabindex="-1">Commit Message 格式 <a class="header-anchor" href="#Commit-Message-格式" aria-label="Permalink to "Commit Message 格式""></a></h2><div class="language-html vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">html</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"><</span><span style="--shiki-dark:#EE6666;--shiki-dark-font-style:italic;--shiki-dark-text-decoration:underline;--shiki-light:#B31D28;--shiki-light-font-style:inherit;--shiki-light-text-decoration:inherit;">type</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">(</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"><</span><span style="--shiki-dark:#EE6666;--shiki-dark-font-style:italic;--shiki-dark-text-decoration:underline;--shiki-light:#B31D28;--shiki-light-font-style:inherit;--shiki-light-text-decoration:inherit;">scope</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">): </span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"><</span><span style="--shiki-dark:#EE6666;--shiki-dark-font-style:italic;--shiki-dark-text-decoration:underline;--shiki-light:#B31D28;--shiki-light-font-style:inherit;--shiki-light-text-decoration:inherit;">subject</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">></span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"><</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">body</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">></span></span></code></pre></div><h2 id="Type-类型" tabindex="-1">Type 类型 <a class="header-anchor" href="#Type-类型" aria-label="Permalink to "Type 类型""></a></h2><table tabindex="0"><thead><tr><th>type</th><th>说明</th><th>示例</th></tr></thead><tbody><tr><td><code>feat</code></td><td>新功能</td><td><code>feat(user): 新增用户导入导出功能</code></td></tr><tr><td><code>fix</code></td><td>修复 Bug</td><td><code>fix(login): 修复验证码过期后仍可使用的问题</code></td></tr><tr><td><code>docs</code></td><td>文档</td><td><code>docs: 更新 API 接口文档</code></td></tr><tr><td><code>style</code></td><td>代码格式（不影响功能）</td><td><code>style: 统一代码缩进</code></td></tr><tr><td><code>refactor</code></td><td>重构</td><td><code>refactor(logic): 优化分页查询性能</code></td></tr><tr><td><code>perf</code></td><td>性能优化</td><td><code>perf(dict): 增加字典缓存减少数据库查询</code></td></tr><tr><td><code>test</code></td><td>测试</td><td><code>test: 添加用户模块单元测试</code></td></tr><tr><td><code>chore</code></td><td>构建/工具</td><td><code>chore: 更新 Composer 依赖</code></td></tr></tbody></table><h2 id="Scope-范围" tabindex="-1">Scope 范围 <a class="header-anchor" href="#Scope-范围" aria-label="Permalink to "Scope 范围""></a></h2><table tabindex="0"><thead><tr><th>scope</th><th>说明</th></tr></thead><tbody><tr><td><code>user</code></td><td>用户模块</td></tr><tr><td><code>role</code></td><td>角色模块</td></tr><tr><td><code>menu</code></td><td>菜单模块</td></tr><tr><td><code>dict</code></td><td>字典模块</td></tr><tr><td><code>job</code></td><td>定时任务</td></tr><tr><td><code>auth</code></td><td>认证授权</td></tr><tr><td><code>upload</code></td><td>文件上传</td></tr><tr><td><code>generator</code></td><td>代码生成器</td></tr><tr><td><code>config</code></td><td>配置</td></tr><tr><td><code>deploy</code></td><td>部署</td></tr></tbody></table><h2 id="示例" tabindex="-1">示例 <a class="header-anchor" href="#示例" aria-label="Permalink to "示例""></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># 新功能（feat）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -m → 指定提交信息（单行简短描述）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#62E884;--shiki-light:#59873A;">git</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;"> commit</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#A65E2B;"> -m</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> "</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">feat(article): 新增文章管理模块</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">"</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># 修复 Bug（fix）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#62E884;--shiki-light:#59873A;">git</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;"> commit</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#A65E2B;"> -m</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> "</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">fix(login): 修复密码错误时未记录登录日志的问题</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">"</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># 文档更新（docs）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#62E884;--shiki-light:#59873A;">git</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;"> commit</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#A65E2B;"> -m</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> "</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">docs: 补充多数据库部署文档</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">"</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># 重构（refactor）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#62E884;--shiki-light:#59873A;">git</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;"> commit</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#A65E2B;"> -m</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> "</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">refactor(logic): 统一删除前校验逻辑</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">"</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># 性能优化（perf）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span style="--shiki-dark:#62E884;--shiki-light:#59873A;">git</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;"> commit</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#A65E2B;"> -m</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> "</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">perf(dict): 增加请求级缓存减少重复查询</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">"</span></span></code></pre></div><h2 id="注意事项" tabindex="-1">注意事项 <a class="header-anchor" href="#注意事项" aria-label="Permalink to "注意事项""></a></h2><div class="warning custom-block"><p class="custom-block-title">禁止事项</p><ul><li>不要提交调试代码（<code>console.log</code>、<code>dump</code>、<code>var_dump</code>）</li><li>不要提交敏感信息（密码、密钥、Token）</li><li>不要提交 IDE 配置文件（<code>.idea/</code>、<code>.vscode/</code>）</li><li>一个 commit 只做一件事</li></ul></div><h2 id="-gitignore" tabindex="-1">.gitignore <a class="header-anchor" href="#-gitignore" aria-label="Permalink to ".gitignore""></a></h2><div class="language-gitignore vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">gitignore</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span># =============================================================================</span></span>
|
||
<span class="line"><span># .gitignore — Git 版本控制忽略规则</span></span>
|
||
<span class="line"><span># =============================================================================</span></span>
|
||
<span class="line"><span># 匹配的文件不会被 git track（不会提交到仓库）</span></span>
|
||
<span class="line"><span># =============================================================================</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span># 运行时目录（ThinkPHP 缓存、日志、编译模板 — 自动生成，无需版本控制）</span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span>runtime/</span></span>
|
||
<span class="line"><span>vendor/</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span># 环境配置（包含数据库密码等敏感信息 — 绝不能提交）</span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span>.env</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span># IDE 配置文件（每个开发者的 IDE 设置不同 — 不应互相影响）</span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span>.idea/</span></span>
|
||
<span class="line"><span>.vscode/</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span># 临时上传文件（用户上传的临时文件 — 不属于代码）</span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span>uploads/temp/</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span># 前端依赖（node_modules 体积庞大 — 通过 pnpm install 重新安装即可）</span></span>
|
||
<span class="line"><span># -----------------------------------------------------------------------------</span></span>
|
||
<span class="line"><span>ui/node_modules/</span></span></code></pre></div>`,14)])])}const g=a(e,[["render",p]]);export{r as __pageData,g as default};
|