程序猿容易轻视的注释和送礼的八项原则
叙说程序猿眼中的人文世界，分享的内容如下：
程序那点事：注释语句的那些事
开脑洞：论程序猿的修养
程序猿人生：成为送礼明礼之人需要了解的八项原则
有趣的HOOKs：代码注释的“不要”原则
程序那点事：注释语句的那些事
拿Java语言来说，注释语句一般包括行注释（//：）、块注释（/**/）和javadoc文档注释（/***/）。加入注释语句的目的一方面是方便自己阅读，更主要的是提高程序的可读性，便于未来他人理解自己的代码。
在学校教授C语言之前，很多学校都在讲FORTRAN和PASCAL语言的时候，那时厉害点的程序猿的go to语句都是用得很厉害的样子，这样程序代码可以更加简短，在内存和硬盘空间大小会被时刻在意的时代，追求精致也是一种很合理的考虑。
随着软件工程的引入，现实中软件的开发也开始不再由一个人就可以完成，而是需要更多人的团队协作，以及软件系统的规模也出现巨大的增长，历史上曾经有IT科学家提出来，应该废除go to语句，其中一个很关键的原因就是需要程序代码需要更好的可读性，所以写注释语句成为了良好的编程行为被要求和推荐。
开脑洞：论程序猿的修养
编程这件事情具有较为明显的”个人创造性“的特点，一个牛掰的程序猿就往往会以追求代码的精致和巧妙为乐趣，而容易忘却编程这件事情已经成为了一个需要被工程化的工作，早已失去了它”艺术“的追求。所以，程序猿中性格偏宅的那些人，我总觉得可能编程会加强TA们的”宅“的倾向，此点不能够不自知。
写注释这件事情如果不去考虑公司的强制要求的话，我觉得可以从程序猿写注释的表现中一窥气其人内心认知的某些部分。记得自己在培训大规模软件开发的课程中，提到过如何强制团队编程时候写注释的方法，就是设置软件版本（Version Control）控制的策略，当程序猿使用版本控制工具进行check-in的时候，检查是否写够了规定数量的注释内容，当然这个方法有一些生硬，当有聊胜于无。
程序猿是否写注释，可能涉及的内心认知包括：团队认识是否已经成为内心的习惯、注释会与专业性有关的认识是否达成了共识、对一种优雅和品质追求的动力强弱、换位思考的习惯、全局观的认识强弱、主动沟通的意识，追求尽可能完美的习惯以及自信的偏差程度等等。
很多的公司和团队可能并不会总是在盯着程序猿们写注释的情况如何，所以程序猿自己编程的时候写注释多少有些”慎独“的意味在里面。“慎独”一词，出自秦汉之际的儒家著作《礼记·中庸》一书：“莫见乎隐，莫显乎微，故君子慎其独也。”所谓慎独自律，就是在别人不能看见的时候，能慎重行事；在别人不能听到的时候，能保持清醒。保持着”三尺之上有神灵“的认知，程序猿们同样可以在自己慢慢写注释的时候，修养自己的”慎独“素质，希望程序猿们都能成为”谦谦君子，温润如玉”的样子。
程序猿人生：成为送礼明礼之人需要了解的八项原则
作为礼尚往来的礼仪之邦的中华民族，留下了大量的这方面的智慧，因为专业教育和工作的原因，许多程序猿在礼尚往来方面的修养和认知是存在一些欠缺的，其中的许多智慧犹如同写注释那般不起眼，可是却是程序猿们建立良好人际关系的“硬核”情商能力。
第一原则 坚定信念：养成送礼的习惯
人之所以有大不同，往往在于内心的信念不同，之所以能够坚持，也是因为内心有一个明确的、认可的信念在支撑着我们的行为。俗话常说：“张口莫骂赔礼者，伸手不打笑脸人。”可是后面其实还有一句更加俗气的话“开口不骂送礼人”！
记得，我上高中的时候，班主任李渲老师对我如慈父般关爱有加，一次在老师吃饭，闲聊的时候李老师告送我一个道理，“世上有不愿意拍人马屁的人，但是绝对没有别人拍自己马屁生气的人！”，因为很是接地气，我一直都记在心里。
可见在我们的历史和文化中，即使对方错在先了，如果对方对我们表现出善意的时候，我们都是不可以对着怼的，那我们日常的任何时候，请相信送礼这件事情绝对是不会让任何人讨厌和不能够接受的，所以请将送礼这件事情坚持到底，落实到生活工作中的方方面面。
第二原则 世人无差：送礼的条件你永远具备
春秋时期辅佐齐桓公成为第一霸主的管仲在《管子·牧民》中说：“仓廪实则知礼节，衣食足则知荣辱”，而后来西汉史学家司马迁在《史记·管晏列传》的引文中改动了一个字：“则”改成了“而”，就有了为后世津津乐道的：“仓廪实而知礼节，衣食足而知荣辱”。
可见司马迁当时应该已经敏锐洞察到了“仓廪实、衣食足”与“知礼节、知荣辱”之间的联系并不是必然的，用今天的话来说就是：“仓廪实、衣食足”是“知礼节、知荣辱”的必要条件，而不是充分条件，“仓廪实、衣食足”只是前提和基础。
其实“礼”与钱和“贵重”并无直接的联系，送礼这件事本身最重要的就是一种对别人的敬意、尊重以及表达自己善意、谢意等的情感表达方式，是希望建立起好的情感联结的一个标志而已。所以，大可不必因为“相对比较”限制了自己的思维，在送礼这件事情上，所有人都是富有之人。送礼之后，我们是不是常常听到这句话“您费心了！”“您是有心之人啊！”，所以用心才是送礼的基础，心人人都有的，不用求人。
第三原则 直触人心：发自内心的礼物最具感染力
日常工作中，我们会发现一个对自己的产品具有无比信念的人，发自自己内心认为自己的产品能够帮助到别人的人，往往在同等能力的情况下，会具有更好的成交结果，为什么呢？其实，人与人之间的交往，除了我们彼此的沟通外，我们相互之间还在交换着大量的信息，我们的内在“心灵”也会自己在沟通，彼此在了解，敏感一点的人直觉力强一些的任人，就会很容易感受到交流内容之外的资讯。所以，我们才会说自己被对方的热情和信心感染到了。
所以，一份什么样的礼物最会打动别人呢？一定是你发自内心的希望送别人礼物的时候！因为你发自内心的缘起，会在所有的层面影响着送礼这个事情中你所有环节的“表现”，而对方也最能够从中感受到你的真心和实意。世间人对真诚是缺乏免疫力的。
第四原则 亲疏无间：越是亲近人越要“礼人”
你应该给谁送礼？答案是：所有与你有关系的人。求人办事的礼可能是大多数人心中的送礼场景，可是“不要空手上别人家“这个场景却也同样的重要。
我们往往会觉得，因为关系不到位，需要”礼“来助力一下，所以”助力礼”的场景大家会重视一些，但是可能是我们人类的一个bug吧，我们容易有“温柔待陌生人，苛刻待家人”的倾向，可是一个人的交往半径决定了，我们的生活中由亲向疏的半径内能够与我们有密切关系的人往往才是我们能否幸福快乐最重要的人，所以，对于这些重要的亲近之人，我们要学会常常“礼人”。
第五原则 拿得出手：送礼的察言观色
送一件拿得出手的礼物，有的时候往往会难到很多人。我的理解是拿得出手的礼物具有两方面需要考虑的因素，我们送礼当然是希望对方愉悦，心生欢喜，所以当然首先是要从对方的角度来选择礼物，可是现实中往往会存在一个情况让我们为难，比如你要送礼的人可能条件很好，存在与你的差距，这个时候，我们应该考虑的就应该是实事求是，根据自己的能力，体现出自己诚意，因为我们可以相信对方会去站在你的情况来“看待”你的礼物。就像是随礼，假设同样的其它条件下，你挣3000元的时候随200元就很好，挣3万的时候随200元就会不合适了。
第六原则 礼轻人意重：送礼的技巧
既然得养成送礼的习惯，会不会让送礼成为自己经济上的负担，很多年轻的程序猿还奋斗在不断改善自身生活条件的路上呢。礼轻人意重往往我们会认为在表达一种送礼的态度和情谊，但是我觉得也同样告诉了我们送礼的技巧，“礼可以轻”。其实在很多的场合，我们带上一点小小的礼物，重要的是要有“带礼物”这个动作发生，而不是你的礼物如何。就如同注释得写，有注释的程序可读性肯定比没有的强。
其实舍得舍得，为什么是舍在先，得在后呢？就是先舍才能后得！而现实中往往考验人的时候是，要你在越不富足的时候越要敢于舍，有点反人性，但是能够反人性的人最后好像容易成功。
第七原则 成熟人格：懂得给领导送礼的那刻
程序猿中的大多数人都是上班一族，我们就说一件事情，该不该给你的领导送礼？说个心里历程，可能很多程序猿和我有过类似的内心戏。上班的时候，我就觉得没有必要给领导送礼，因为我们是凭技术吃饭的人，专业能力厉害，把工作做好了，领导就应该会认可自己的，绝不会因为送不送礼影响自己，所以，那个时候我是不会去考虑送礼的，虽然有点时候，比如回老家是不是随便给领导带点土特产，又觉得不好意思，有种怕被礼物耽误了被人正确评价自己能力的感觉。
后来，创业了，自己做领导了，因为是做技术出身的领导，多少觉得自己的专业能力还是可以的，所以，加之了解自己作为程序猿时候关于送礼的那些内心戏，所以，不知道为什么就对员工送礼这件事情有些微微的抵触，总觉得员工把工作做好了就行，不要搞这些“没有用”的东西。
再后来，应该是第四次创业的时候吧，我突然发现送礼的员工其实是一种成熟的表现，我开始认可了员工送礼这件事情。首先，我开始理解这件事情，员工送礼就是希望表达对领导的敬意，就算是送礼的意图中有希望你照顾TA的成分，又有什么不可以的呢？我有的时候觉得在这件事情上理解员工，其实也是一种慈悲的心态，大家其实为了能够更好的生活都不容易。其次，看待送礼这件事情是领导自己的心态问题，自己不要有“被贿赂”的感觉和看法不就好了，工作该怎么要求就怎么要求，而且照顾好员工不也是企业发展的内在需要嘛，所以，我也工作上这碗水还是会端平的，也不会对不送礼的员工有任何的想法。
可是，人非圣贤，高中班主任告诉我的道理，“世上有不愿意拍人马屁的人，但是绝对没有别人拍自己马屁生气的人！”同样于我有用，收到礼物的时候我还是有享受的，也许也会刺激到我内心柔软的部分，在有些个性化的事情上，也是会有照顾一些的冲动，至于是否会潜移默化地影响到管理的公平性问题，没有研究结果可以分享，不过我想说的是，受人之礼，也该有感恩之心，把公司做好，也是对大家的回报。
上面四张图片的礼物，是员工送给我的生日礼物，一直珍藏着，让过去的工作记忆中留下了很多的情谊和回忆，每每看到它们，还是内心愉悦的。
第八原则 万法兼空：送礼的境界
佛法常常教诲大家要“广行布施"，因为布施可以给功德主带来”福报“，佛法是修心之法，布施可以对治和调整我们悭吝自私的内心习气，让我们变得更好。佛法中布施的时候讲到最如法的布施是有要求的，那就是要有不求回报舍出去的发心，还要忘记自己是布施的人、忘记布施的对象最好忘记曾经布施这件事情。
送礼能够让别人内心愉悦，也是有功德的，所以，要送礼就认真地去送。如法布施的要求其实可以让我们看待送礼这件事情的时候，如果出现不如意之处，可以作为心理建设的一个参考。要不然，有的朋友会常以自己是个懂得送礼的明理之人而沾沾自喜，有的会为送礼的结果不达预期而纠结，有的会因为对方失礼产生出来一些不良的情愫等等，送礼之事本就是世间万象的一个缩影，不如意之处总还是有的。
有趣的HOOKs：代码注释的“不要”原则
偶然的机会拜读了CSDN博客上一个“breaksoftware"博主的一篇博文“谈代码注释”，标题很简单，主要就是介绍我上面标题写的内容，我们写代码注释的时候需要注意的“不要”和“要”的规矩都是什么，文风很有趣儒雅，也正好切合我这个主题，就引用过来了，这里感谢breaksoftware君的好文。
谈代码注释
@breaksoftware在《谈代码注释》的开头写道：“只要写代码，就会遇到代码注释的问题。在不同的公司，不同的项目组，不同的项目中，可能会有不同的注释标准。有些标准让我们感觉很受益，有些则让我们感觉很反感。而对于没有明确标准的项目，我们往往会遇到“百家齐放，百家争鸣”般的注释。我无法给出一个明确的标准，只是在此探讨下：什么样的注释不应该写，什么地方需要写注释。”
公众号文章著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
程序猿容易轻视的注释和送礼的八项原则相关推荐
- 人情世故之送礼八项原则
作为礼尚往来的礼仪之邦的中华民族,留下了大量的"人情世故"的智慧和规矩,其中送礼的智慧并不那么起眼,可却是每一个人建立良好人际关系的"硬核"情商能力. 第一原则 ...
- 216位攻城狮送给程序猿的10个新年礼物
新的一年来临啦 又到了美好的互送礼物(吃土)的季节~ 如果你的男神是程序猿 如何能让他在代码丛中多看你一眼? 如果你就是程序猿 是不是经常烦恼朋友送的礼物像bug? 现隆重推出 网易云信216位攻城狮 ...
- 【分享程序员的生活】在国企里面当程序猿是一种怎样的体验！！？？
我正在参与<新程序员>有奖征文,相关链接https://marketing.csdn.net/p/52c37904f6e1b69dc392234fff425442 在国企里面当程序猿是一种 ...
- 十二星座程序猿怪咖个性_你中了几条？
原文链接 摩羯座 摩羯希望被重用,他们不喜欢自己一天没有事情干,他们希望自己忙起来,他们给别人说"没时间.忙着呢"的时候会非常的爽! 他们喜欢把控全局,因此他们肯定是个合格的架构师 ...
- 在国企里面当程序猿是一种怎样的体验?
在国企里面当程序猿是一种怎样的体验? 前言 2018年底,我通过半天的笔试及面试加入一家(某一线城市事业单位全资控股)研究机构(省级研究院),任职软件工程师:在这边工作了整整两年半,目前已经在做跳槽准 ...
- 1024 程序员节 | 请对身边的程序猿好一点
程序员节起源 程序员的工作我们都知道,编程嘛.但为什么程序员节要在1024呢?1024最早火起来是因为一个"不可描述"的论坛,那里的回帖机制是:新用户发过贴之后,过1024秒才能发 ...
- 过年回家应对七大姑八大姨，程序猿绝了！
转眼又到年关,所谓年关,也就是不断地过关坎.七大姑八大姨又要免不了地问各种问题轮番"进攻".这是每年过年离不开的烦恼! 挣多少钱啊? 有对象了没啊? 啥时候结婚啊? 啥时候买房买车 ...
- 程序猿小白应该注意什么
在学校敲代码的时候,考虑的可能是怎么实现这个功能,怎么样把功能做的酷一点,可是当你进入了公司,你就会发现可能代码把功能实现是一方面的,你代码还需要良好的代码风格,命名规范,可读性易于维护,以及性能等等 ...
- 史上最良心程序员，在代码注释里，告诉这家公司有多坑
程序员压力大,需要一个地方发泄,可又不能因此断了思路,于是代码注释成了绝佳的地方. 去年虾米音乐APP被爆出,代码注释中含有歧视侮辱性的词汇,将活动赠送的vip,标注为穷xvip.事件一曝光,就受到广 ...
最新文章
- 面试官:为什么在系统中不推荐双写?
- Java集合中HashMap日常问题及解决办法
- C–gcc命令行下的参数
- 每个人都该懂点的版本管理技能
- WPF 重要新概念读书笔记(转)
- 云智能遥控开关设备再物联网领域的应用：智能养殖高效、生态、安全！
- mybatis-plus3.5.1学习笔记
- win10启动项_win10你的电脑遇到问题需要重新启动
- php:页面乱码的解决方法
- GitHub 标星 6W：口吐芬芳终端助手
- 自组织网络（Ad hoc）
- 计算机文件保存方式,Word文档的三种保存方式
- MySQL异常 Incorrect string value: '\xE8\xB5\xB5\xE6\xB4\x8B' for column at row的解决方案
- vivado ILA核使用教程
- 创立仅一年GMV突破3亿！这个新锐品牌如何在快手实现爆发？
- 某选秀比赛的晋级规则是：如果7个评委中，有4个及以上评委投赞成票。试用数组编写程序判断某选手是否晋级
- 如何上手机上不了无线网络连接服务器,手机连接不上路由器无线网络怎么处理...
- 干货盘点！推荐程序员日常使用的5款工具软件
- 分享12个Kindle书籍资源地址，你想要的这里都有
- podman开机自启