2022年，继续做开源的朋友-续篇之邮箱

在《2022年，继续做开源的朋友》中，讲述了参与社区贡献的几点注意事项。本文做些补充，专门来说说开源贡献中的邮箱的那些事儿。

1、 Gitee账户邮箱管理

注册Gitee账户后，进入个人信息设置页面（Gitee首页，左上角头像下拉-设置，见下图⑴），在左侧导航，可以看到下图中⑵处的邮箱管理，点击进去。可以看到Gitee提供了丰富的邮箱管理的功能。⑶处列出了设置的全部的邮箱，并显示邮箱用途分类。⑷处设置是否公开自己的邮箱，如果不设置邮箱，Gitee会提供一个默认的邮箱作为邮箱提交地址。但是，作为开源社区参与者，建议大家公开自己的邮箱。这样会多提供一个与社区互动交流的渠道。⑸处的主邮箱用于接收安全相关的通知，如果自己的Gitee账户比较重要，为了安全起见，一定设置一个可以及时查看邮件的邮箱地址。 ⑹处设置提交邮箱，在提交代码的git message里显示该邮箱地址。又想公开邮箱，又不想保留自己的主邮箱，可以在⑺处设置公开邮箱，然后再邮箱设置里，给自己自动转发邮件到自己的主邮箱。

2、开发者原创声明签署signoff邮箱

大型开源社区一般都需要开发者签署原创声明。以OpenHarmony为例，访问文档仓https://gitee.com/openharmony/docs/blob/master/zh-cn/readme.md，在页面最下方可以看到参与贡献的链接：https://gitee.com/openharmony/docs/blob/master/zh-cn/contribute/%E5%8F%82%E4%B8%8E%E8%B4%A1%E7%8C%AE.md 。进去，在新页面，可以看到：您必须首先签署“开发者原创声明”，然后才能参与社区贡献。并提供了两个链接，分别用于签署原创声明和检查原创声明状态。

开发者原创声明(DCO, Developer Certificate of Origin)，请自信查看原创声明协议内容，提交代码前，需要确保代码是自己原创，且有适当的开源许可证授权。

需要填写姓名，这个姓名填写什么不太重要，可以是自己的昵称和gitee账户，不空着就行。关键的是邮箱地址，像openharmony代码仓提交代码时，会检查这个邮箱地址。填写完毕邮箱后，发送验证码，查看邮箱中接收到的验证码。在原创声明页面，添加邮箱验证码，点击同意签署按钮，完成签署。可以通过检查原创声明状态来验证自己的邮箱是否完成过签署。

3、检出代码前的邮箱设置

获取代码可以参考链接。检出代码中设置邮箱操作比较简单，执行如下命令即可。需要设置的邮箱信息，要和签署原创声明的邮箱一致。

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

4、提交代码时的邮箱设置

贡献代码可以参考链接。提交贡献代码中设置邮箱操作比较简单，执行如下命令即可。需要设置的邮箱信息，要和签署原创声明的邮箱一致。

git commit -sm  "xxxxxx"  // 提交信息包含signoff邮箱

您可能会在前次提交的基础上，继续编辑构建并测试更多内容，可以使用commit --amend继续添加提交。

如果使用图形化界面工具如TortoiseGit，会更简单。直接点击按钮“Add Signed-off-by”，在git commit message里会自动添加Signed-off-by: kenneth <zhushangyuan@XXX.com>。

5、PR未通过DCO校验时的处理

如果错过了上述步骤中描述的操作，强行提交代码时。门禁会同不错，提示输出如下：

根据情况，确认是否签署过原创声明。如果没有签署过就去签署，签署过的话，可能提交代码时，没有指定签署邮箱信息。参考FAQ,就可以解决。

如何在Commit中添加signoff记录
使用git commit -s 或 git commit –signoff 命令提交。

如何追加signoff到上一次commit?
执行git commit --amend --signoff命令 。

小结

没有必要总结。嗯。