程序猿容易轻视的注释和送礼的八项原则

 叙说程序猿眼中的人文世界，分享的内容如下：

程序那点事：注释语句的那些事

开脑洞：论程序猿的修养

程序猿人生：成为送礼明礼之人需要了解的八项原则

有趣的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在《谈代码注释》的开头写道：“只要写代码，就会遇到代码注释的问题。在不同的公司，不同的项目组，不同的项目中，可能会有不同的注释标准。有些标准让我们感觉很受益，有些则让我们感觉很反感。而对于没有明确标准的项目，我们往往会遇到“百家齐放，百家争鸣”般的注释。我无法给出一个明确的标准，只是在此探讨下：什么样的注释不应该写，什么地方需要写注释。”

 

 公众号文章著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。