inBuilder低代码平台开发者分享课丨提交PR的正确姿势

目前开源技术已经得到广泛应用，特别是在云计算、人工智能、区块链等领域。使用开源软件、参与开源软件的开发已成为开发者提升自己开发能力，打造个人名片的有效渠道之一。浪潮最近也是发布了免费的企业级低代码平台 —— 浪潮海岳inBuilder开源社区版，它是基于统一业务建模语言UBML开源项目的一个可以广泛使用的发行版。欢迎对低代码领域感兴趣或者在低代码领域有耕耘过的有志之士加入UBML开源社区的大家庭中来贡献自己的力量，与社区共成长。

参与社区贡献的第一步，我们需要知悉如何正确的提交PR。

什么是PR？

PR是Pull Request的缩写。在开源社区中，Pull Request是一种提交代码的方式。开源社区中的开发者可以在代码库中创建分支，并对代码进行修改和更新，然后提交Pull Request请求，请求贡献者帮助审核和合并这个分支。审核者会审查代码是否符合代码库的代码规范，并确认修改后的代码不会对原有代码产生影响，然后批准合并代码，或者提出改进意见，待贡献者对修改意见进行修改后再次提交PR请求。通过这种方式，代码库可以不断得到完善和更新，也可以促进开源社区的交流与合作。

怎样提交PR?

以开源UBML项目中farris-vue为例，在注册gitee账号并登录后，按照以下步骤即可。

第一步是fork开源的项目，将其克隆到自己的本地代码库:

在自己的仓库中，就可以看到fork下来的代码。

第二步，本地进行修改，提交commit：

将代码clone到本地，使用编辑器进行代码的修改和编写完成开发工作，将修改的工作先提交到自己的仓库中。

第三步，提交Pull Request：

在Gitee上找到刚才修改的地方，点击Pull Request按钮，填写请求信息，并等待审核即可。

如何正确提交PR

PR提交格式可以根据具体的项目要求和开发团队的协作流程来定义，不同的项目可能会有略微不同的规范。下面是UBML社区中常用的PR提交格式规范。

1) 描述

该部分主要是详细描述本次提交完成的任务，包括更新了哪些功能、修复了哪些问题；同时，也可以阐述一下本次提交的背景、意义和目的等相关信息。

2) 关联Issues

开源社区中的Issues通常是指项目开发和维护过程中所遇到的问题或者bug。在开源项目中，用户可以提出Issue来报告发现的问题，然后由开发者对这些问题进行修复或者反馈，以提高项目的质量和稳定性。除了bug之外，issue还可以用于功能请求、建议和讨论等用途，正确的关联Issue可以方便社区中其他人员参与相关的问题的讨论和交流。

3) 测试用例

描述可以测试自己工作内容相关的案例，相关人可以根据案例相关描述来复现体提交的PR中相关问题修复或者新增功能检验的场景。

4) 展示效果

该部分通常用截图的形式，展示的内容通常是bug修复后程序运行的效果或者新增功能特性的运行效果，效果展示尽量简洁直观，能够快速让相关人员在极短的时间内确定测试用例运行后呈现出来的理想结果。

下面以farris-vue中实现Tags组件的Issue为例,在我们领取这个Issue并且完成该新功能后，提交PR时就可参考以下的简单案例来写：

标题：实现Tags组件

描述：

在本次更改中增加了一些代码，以实现Tags组件的相关功能。

用户可以通过引用该组件，且可以通过一些属性的配置，实现不同风格Tags的展示工作。

测试用例：要视具体情况而定，这里省略，具体可以去UMBL中参考。

展示效果：

结语

最后，高效且正确地提交PR不仅可以显著地提高开发效率，满足了团队高的需求也让自己学习到了更多的知识。同时掌握了这技能，也让开发者以更高的姿态跨越技能线，进而迈向更专业的技能大师之路。另外无需担心自己的开发经验和水平达不到，在社区中你都可以找到自己的兴趣点和正确定位，赶紧加入UBML社区并开始正确的提交自己的第一次PR，与社区共同成长，正式开启自己开源之旅吧！

参与源代码贡献，请到UBML开源社区

下载使用inBuilder开源社区版，请到inBuilder低代码社区