配置项目级的提交规则

更新时间：2024-12-11 GMT+08:00

查看PDF

提交规则概述

CodeArts Repo支持为代码的提交建立校验、限制规则，以确保代码质量。

下面将介绍“配置项目级的提交规则”及“常见的正则表达式示例”。

配置项目级的提交规则

在代码托管首页，进入项目首页，选择“设置” > “策略设置” > “提交规则”，单击“新建提交规则”，参数填写请参见表格表1。

表1 项目级提交规则的参数填写
参数名	参数说明
规则名称	必填参数，自定义规则名称。
分支规则	必填参数，需要输入完整规则名或创建一个正则表达式。需要对输入进行校验，包括分支名的校验和正则表达式校验。
提交规则	非必填。提交信息匹配规则：提交信息默认为空，不会对提交信息校验，任何提交信息都可以提交。若符合正则匹配，则允许提交。您也可以设置在提交信息中必须包含工作项单号，实现代码的E2E追溯，限制500个字符。提交信息负面匹配规则：提交信息负面匹配规则默认为空，不会对提交信息校验，任何提交信息都可以提交。若符合正则匹配，则不允许提交。容限制500个字符。提交人：提交人默认为空，不会对提交人校验，任何人都可以提交，限制200个字符。提交人可通过“git config -l”查看user.name的值，并通过“git config --global user.name”设置user.name的值。例如：设置提交人规则：([a-z][A-Z]{3})([0-9]{1,9}) 提交人邮箱地址：提交人邮箱地址默认为空，不会对提交人邮箱地址校验，任何邮箱地址都可以提交，限制200个字符。提交人可通过“git config -l”查看user.email的值，并通过“git config --global user.email”设置邮箱。例如：设置提交人邮箱规则：@my-company.com$
文件基本属性规则	非必填。禁止提交的文件名称：禁止提交的文件名称规则默认为空，不会对文件名校验，任何文件都可以提交，建议正则编写时使用规范的正则语句进行匹配，文件名禁用规则处默认会根据规则校验文件所属路径，限制2000个字符。例如：设置禁止提交的文件名称规则：(\.jar\|\.exe)$ 单文件大小限制(MB)：文件大小上限默认显示为50，表示添加或更新文件大小超过50MB，推送将被拒绝。说明：创建仓库时默认的提交规则（default）中的单文件大小限制为50MB，新建提交规则时单文件大小限制默认推荐50MB，最大不可以超过200MB。
二进制规则	非必填。二进制规则默认不勾选，默认勾选“禁止禁止新增二进制文件（对特权用户无效）”。“允许修改二进制文件”勾选后，提交文件为modify状态的二进制文件不会拦截，可直接上传。二进制文件可以直接删除，不会进行二进制检查。禁止新增二进制文件（对特权用户无效）。允许修改二进制文件（对特权用户无效）。二进制文件白名单（可直接入库的文件，限制2000个字符）。特权用户（特权用户上限为50人）。说明：如果特权用户已经不是仓库成员，单击保存会提示“特权用户校验失败”，需要将非仓库成员的特权用户移除才能保存成功。
规则生效时间	非必填。在生效日期之后创建的所有提交都必须与hook设置相匹配才能被推送。如果此字段为空，则无论提交日期如何，都将检查所有提交。

常见的正则表达式示例

常见的正则表达式示例可参考常见的正则表达式示例。

表2 常见正则表达式示例
规则	示例
单个a或b或c字符	[abc]
非a或b或c的字符	[^abc]
在a到z范围内的小写英语字母字符	[a-z]
在a到z范围外的字符	[^a-z]
在a到z或A到Z范围内的大小写英语字母字符	[a-zA-Z]
任意单个字符	.
选择 - 匹配 a 或 b	a\|b
任意空白字符	\s
非空白字符	\S
阿拉伯数字字符	\d
非阿拉伯数字字符	\D
字母、数字或下划线的字符	\w
非字母、数字或下划线的字符	\W
匹配括号中的内容（不捕获）	(?:...)
匹配并捕获括号中的内容	(...)
零个或一个a	a?
零个或更多a	a*
一个及以上a	a+
三个a	a{3}
三个a以上	a{3,}
3到6个a	a{3,6}
文本开头	^
文本末尾	$
单词边界	\b
非单词边界	\B
换行符	\n
回车符	\r
制表符	\t
空字符	\0

父主题： 新建并配置CodeArts项目设置

上一篇：新建并配置CodeArts项目设置

下一篇：配置项目级的代码仓库设置

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

配置项目级的提交规则

提交规则概述

配置项目级的提交规则

常见的正则表达式示例

意见反馈

文档内容是否对您有帮助？

文档反馈