标题: 【git 教程-番外1】Conventional Commits——commit message 的社区规范
作者: #废寝忘食
板块: #文档共建
编号:
帖子: https://linux.do/t/topic/1357726
时间: 2025-12-24 17:49:10
摘要:
作者: #废寝忘食
板块: #文档共建
编号:
1357726帖子: https://linux.do/t/topic/1357726
时间: 2025-12-24 17:49:10
摘要:
Conventional Commits——commit message 的社区规范
在配合版本工具（如 git）开发时，往往需要对项目多次修改、多次提交。且每次提交可能都是不同的内容，比如新增功能、debug 或者只是改了些文档。所以，记录下每次 commit 内容是很有必要的，git 工具本身也要求开发者在 git commit 时必须要加上 -m <message>，用于描述本次提交修改的内容。github 上大多数项目都使用了类似的格式
那么该如何写出清晰的 commit message 呢？有没有最佳实践呢？这就是本文介绍的内容：Conventional Commits，开发者社区内的 commit message 的规范
发展历史简述
Conventional Commits 格式（不过那时候还不叫这个名字）最早由 Angular 项目的团队使用，要求使用指定的格式来写 commit message。这种格式能明确说明每次 commit 的类型、内容。因为源自Angular 项目，因此，也有些教程 Conventional Commits 称其为 Angular 规范
后来，这种格式被社区广泛运用，并补充了更正式的描述，使其成为一种规范
Conventional Commits 在其文档中称 约定式提交规范是一种基于提交信息的轻量级约定，它提供了一组简单规则来创建清晰的提交历史
Conventional Commits 的结构
该规范认为，每次提交的 commit message 都包含三部分：type, Body, Footer
<type>(<scope>): <description>
// 空一行
<body>
// 空一行
<footer>
其中，Header 是必须的，剩余两个都可以省略
这里给出一个完整的 commit message 实例：
fix: prevent racing of requests
Introduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.
Remove timeouts which were used to mitigate the racing issue but are
obsolete now.
Reviewed-by: Z
Refs: #123
Header
Header 部分只有一行，包括三个字段：type（必需）、scope（可选）和subject（必需）
<type>[(<scope>)]: <description>
type
type 字段用于说明 commit 的类别，：
feat：在代码库中新增了一个功能（feature）
fix：在代码库中修复了一个 bug
BREAKING CHANGE：引入了破坏性 API 变更。也可以表示为 <type>(<scope>)!，即增加一个感叹号
除了上面的也可以使用其它提交类型，例如 Angular 团队推荐的：
docs：文档（documentation），不涉及代码逻辑，针对 “文字说明”（文档、注释）
style： 修改代码的样式（不影响代码运行的变动），代码风格的更改，不影响程序逻辑。针对 “代码格式”，例如函数命名、换行
refactor：重构（即不是新增功能，也不是修改bug的代码变动），优化代码结构、逻辑或命名，提高可读性、复用性，但不改变功能
perf：性能优化，例如提升代码的性能、减少内存占用等
test：修改测试用例，例如添加、删除、修改代码的测试用例等
chore：对构建、配置、脚本或依赖的调整，不影响代码逻辑和功能
build：修改项目构建系统，例如修改依赖库、外部接口或者升级 Node 版本等
ci：修改持续集成流程，例如修改 Travis、Jenkins 等工作流配置
如果 type 为 feat 和 fix，则该 commit 将肯定出现在 Change log 之中
当一次提交包含了多种类型的更改（例如同时增加了新功能和补充了单元测试），核心的处理原则是：根据提交对项目产生的实际影响，选择一个最主要、最核心的变更类型作为本次提交的 type，然后在提交信息的正文（Body）中详细描述所有具体的更改内容
scope
scope用于说明 commit 影响的范围，比如数据层、控制层、视图层等等，视项目不同而不同
subject
subject是 commit 目的的简短描述，不超过 50 个字符
body
Body 部分是对本次 commit 的详细描述，也称正文，可以分成多行。下面是一个范例：
More detailed explanatory text, if necessary. Wrap it to
about 72 characters or so.
Further paragraphs come after blank lines.
- Bullet points are okay, too
- Use a hanging indent
正文内容自由编写，并可以使用空行分隔不同段落
使用第一人称现在时，比如使用 change 而不是changed或changes
应该说明代码变动的动机，以及与以前行为的对比。
Footer
在正文结束的一个空行之后，可以编写一行或多行脚注（Footer）
其实 Conventional Commits 并没有明确规定脚注的内容，但是 阮一峰的网络日志-Angular 规范 根据其开发经验给出了如下建议——
Footer 部分只用于两种情况：不兼容变动和关闭 Issue
如果当前代码与上一个版本不兼容，则 Footer 部分以BREAKING CHANGE开头，后面是对变动的描述、以及变动理由和迁移方法。
BREAKING CHANGE: isolate scope bindings definition has changed.
To migrate the code follow the example below:
Before:
scope: {
myAttr: 'attribute',
}
After:
scope: {
myAttr: '@',
}
The removed `inject` wasn't generaly useful for directives so there should be no code using it.
关闭 Issue
如果当前 commit 针对某个issue，那么可以在 Footer 部分关闭这个 issue 。
Closes #234, #123
Revert
还有一种特殊情况，如果当前 commit 用于撤销以前的 commit，则必须以revert:开头，后面跟着被撤销 Commit 的 Header。
revert: feat(pencil): add 'graphiteWidth' option
This reverts commit 667ecc1654a317a13331b17617d973392f4
Body部分的格式是固定的，必须写成 This reverts commit <hash>.，其中的 hash 是被撤销 commit 的 SHA 标识符。
参考资料
廖雪峰的 git 教程
阮一峰的网络日志-Angular 规范
Angular 仓库贡献指南
Conventional Commits 中文文档 及其 github仓库
GPT-5.2
标题: 有没有那种免费的还又稳定的白嫖机场推荐
作者: #andrew-new
板块: #福利羊毛
编号:
帖子: https://linux.do/t/topic/1357728
时间: 2025-12-24 17:49:37
摘要:
作者: #andrew-new
板块: #福利羊毛
编号:
1357728帖子: https://linux.do/t/topic/1357728
时间: 2025-12-24 17:49:37
摘要:
有没有那种免费的还又稳定的白嫖机场推荐
标题: Daytona IO 这个服务有啥用呢?
作者: #ieoeurortior
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357729
时间: 2025-12-24 17:50:10
摘要:
作者: #ieoeurortior
板块: #搞七捻三
编号:
1357729帖子: https://linux.do/t/topic/1357729
时间: 2025-12-24 17:50:10
摘要:
daytona.io
Daytona - Secure Infrastructure for Running AI-Generated Code
Deploy Al code with confidence using Daytona's lightning-fast infrastructure. 90ms environment creation,
stateful operations, and enterprise-grade security.
薅了$1000
但是不知道有啥用?类似docker的东西.我直接用docker不就得了.
标题: 问问大家，komari大家都是部署在哪里的？
作者: #666
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357735
时间: 2025-12-24 17:51:26
摘要:
作者: #666
板块: #搞七捻三
编号:
1357735帖子: https://linux.do/t/topic/1357735
时间: 2025-12-24 17:51:26
摘要:
到现在，手上也有几台小鸡了，打算用komari搞个探针，问问大家，komari大家都部署在哪里的。是拿其中一台VPS部署吗，还是用免费docker平台？
Render和railway之类的，免费计划都没有挂载数据，一重启数据就丢失，所以都不太合适。论坛里面的Leaflow平台倒是可以挂载数据，但是免费金额没多少，也用不了多久。拿一台VPS来部署，然后自己监控自己又觉得怪怪的。
标题: (AI生成)对Reddit等社区关于GLM4.7和MiniMax M2.1的调查报告
作者: #xanon_xd
板块: #国产替代
编号:
帖子: https://linux.do/t/topic/1357739
时间: 2025-12-24 17:52:15
摘要:
作者: #xanon_xd
板块: #国产替代
编号:
1357739帖子: https://linux.do/t/topic/1357739
时间: 2025-12-24 17:52:15
摘要:
这两个模型相差1天推出。我个人也是对两个模型的评价比较好奇。看了站内的讨论，感觉大家对这两个模型的评价有好有坏，没有一边倒的意见。因此也想看看国外社区的意见。因此使用Gemini Deep Research生成了两篇报告。我看了一下发现报告对两个模型的评价也还蛮中肯的，这里发出来供各位佬友参考。
我在Prompt中明确提到不使用国内技术论坛的数据，这是为了屏蔽官方营销宣传影响带来的影响。主要关注和用户体验相关的评论。
下面是GLM-4.7报告的截图：
下面是MiniMax M2.1报告的截图：
标题: 送一个88code free 码
作者: #ghost
板块: #福利羊毛
编号:
帖子: https://linux.do/t/topic/1357741
时间: 2025-12-24 17:52:20
摘要:
作者: #ghost
板块: #福利羊毛
编号:
1357741帖子: https://linux.do/t/topic/1357741
时间: 2025-12-24 17:52:20
摘要:
直接上车不废话
VWET-SBJ3-5J35
用了说一声
标题: 求助一下我需要给佬发CDK 我需要怎么发捏
作者: #诺河
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357742
时间: 2025-12-24 17:53:29
摘要:
作者: #诺河
板块: #搞七捻三
编号:
1357742帖子: https://linux.do/t/topic/1357742
时间: 2025-12-24 17:53:29
摘要:
我想给前100发邮箱的送CDK但是我不知道怎么发
标题: 求助帖 O.o?
作者: #AKAgloria
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357744
时间: 2025-12-24 17:53:40
摘要:
作者: #AKAgloria
板块: #搞七捻三
编号:
1357744帖子: https://linux.do/t/topic/1357744
时间: 2025-12-24 17:53:40
摘要:
各位佬们这个只要当天被点赞了就算吗，每天被点赞次数有限制吗
标题: 【开源】Drawio2GO V1.1更新：更为美观，更多功能，流程图多页编辑支持，MPC服务，画布上下文
作者: #Menghuan1111
板块: #开发调优
编号:
帖子: https://linux.do/t/topic/1357750
时间: 2025-12-24 17:55:08
摘要:
作者: #Menghuan1111
板块: #开发调优
编号:
1357750帖子: https://linux.do/t/topic/1357750
时间: 2025-12-24 17:55:08
摘要:
感谢各位佬友之前的尝试和反馈，佬友反馈的问题好多之前都没想到 现在终于把V1.1版本给憋出来了，直接上图介绍新功能
github.com
GitHub - Menghuan1918/drawio2go: A modern DrawIO editor application. AI-Powered,...
A modern DrawIO editor application. AI-Powered, Human-AI Collaboration | AI 加持，人机共绘drawio
MCP服务
现在应用支持以HTTP的方式启动MCP服务，这样就可以在其他喜欢的客户端中使用啦~
更好的是，在其他应用中使用MCP调用时，drawio内容依然会被版本管理所控制，你依然可以随时在版本页面中和以往的版本对比/随时回滚到某一个版本(具体可以看github README里的演示视频)：
多页编辑
当存在多页drawio的时候，可以在输入框上方选择AI操作的页面范围。选择后所有的drawio工具调用都只会在选定的页面内生效
画布上下文
在应用中，如果开启了画布上下文，对话时会自动将在画布中使用鼠标选择的对象ID传递给AI
(不过网页部署版本中没有这个功能…因为这个功能需要js注入，网页没法实现)
其他优化
特别感谢 @xy3 的测试，优化了诸多API请求的问题~现在模型编辑页面能够同时测试模型连通性和function call能力了
同时还优化了很多地方的UI和深色模式适配(比如这个模型选择弹窗我觉得是真好看 )
不过还有很多地方还有待打磨，比如默认的系统提示词(用claude生成的，没怎么调试)等等…等待有大佬来提建议优化了
谢谢看到这儿的佬友，要是觉得有用(或者未来有期)的话点个 吧
标题: 小红书的 ai 内容 看有非常多玩酒馆的 这类人群画像是怎么样的？
作者: #RWDai
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357751
时间: 2025-12-24 17:55:11
摘要:
作者: #RWDai
板块: #搞七捻三
编号:
1357751帖子: https://linux.do/t/topic/1357751
时间: 2025-12-24 17:55:11
摘要:
在小红书刷到很多女生在玩这个，颠覆了我的认知。毕竟一般女生连电脑杀毒都不会 是怎么搞定酒馆的？而且玩的专业程度和我们站内差不多 也搞什么 公益站 gemini 科学上网？？
进一步思考 我们如果把合法的部分 包装成APP 降低使用门槛会有市场吗？ 肯定还是有一部分人想玩但是搞不定的吧？
有没有了解的佬，或者你就是这类女生出来现身说法分享一下感受？
标题: 佬们 m1pro 32g ➕1t 入手的话，可以再战多久？
作者: #Xiao Samuel
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357762
时间: 2025-12-24 17:57:05
摘要:
作者: #Xiao Samuel
板块: #搞七捻三
编号:
1357762帖子: https://linux.do/t/topic/1357762
时间: 2025-12-24 17:57:05
摘要:
6400价格
标题: L站用学校邮箱注册的，毕业之后邮箱不能用了怎么办
作者: #shixuan
板块: #搞七捻三
编号:
帖子: https://linux.do/t/topic/1357768
时间: 2025-12-24 17:58:52
摘要:
作者: #shixuan
板块: #搞七捻三
编号:
1357768帖子: https://linux.do/t/topic/1357768
时间: 2025-12-24 17:58:52
摘要:
如题，佬们。我L站用学校邮箱注册的，毕业之后邮箱不能用了怎么办，虽然可能还有四五年毕业