保持一致 (Be Consistent)

在你编辑某块代码时,看看周围的代码是什么风格。
如果它们在数学操作符两边都放了空格,那么你也应该这样做。
如果它们的代码注释用 # 井号包成了一个盒子, 那么你也应该这样做。

风格指南存在的意义是 让看代码时能关注 “代码说的是什么”。
而不是 “代码是怎么说这件事的”。这份整体风格指南就是帮助你做这件事的。
注意局部的风格同样重要。如果一个部分的代码和周围的代码很不一样。
别人读的时候思路可能会被打断。尽量避免这一点。

Google C++ Style Guide

[google-c++-comments]: https://google.github.io/styleguide/cppguide.html# Comments
[google-python-comments]: https://google.github.io/styleguide/pyguide.html# Comments