logo标签列表

现有标准样式和编码规范文档

c++coding-styledocumentationstandards
15
1
《Effective C++》是由SCOTT MeyerS所著...Eric Meyer是一位网页设计师和CSS专家... :-p - paercebal
11个回答
9
《C++编程规范：101条规则、指南和最佳实践》(C++深度系列)，作者为Herb Sutter和Andrei Alexandrescu。

非常好的书，可以创建您自己的编码标准，因为每个公司都不同，并且有可能您的公司不是谷歌或NASA。 - Nikko
7
我认为采用哪种编码规范并不重要，只要所有人都能遵守即可。但有时候这很难，因为有些风格可能不符合人们的口味。例如，人们会争论是否在所有成员变量前加上m_是“漂亮”的。

我已经使用和修改了Geosoft标准一段时间了，这些标准适用于C ++。还有一些其他的what-is-your-favorite-coding-guidelines-checklist线程。

我选择使用m_，但我认为它很丑！ - Simon Buchan
5

嗯，奇怪的问题。只需选择大多数团队成员熟悉的标准即可。为您的团队制定一些调查。不确定SO在这方面如何帮助 :)

5
C++的最佳标准之一。 - ArBR
3
您提供的链接已经失效，考虑到它是7年前发布的！这是有效的链接：NASA C++风格指南。 - Ravi
3

我为一家英国大公司编写了编码规范，非常注重解释我选择某些事物的原因，而不仅是一些“你必须”式的宣言。(-:

如果要快速解决问题，建议强制执行以下内容：

  • Scott Meyers的《Effective C++第三版》（亚马逊链接）- 如果您能找到这本书的第一版副本，请购买，因为后来的版本中删除了面向对象设计的概述。)-:
  • Scott Meyer的《Effective STL》（亚马逊链接）- 使用STL可以有效地使用C++。
  • Steve McConnell的《代码大全2》（亚马逊链接）- 不仅仅针对C++，但充满了许多优秀的见解。
3
编码规范只有在帮助你编写代码时才有意义。所以它们只需要保持你的代码一致性（即如果有人将变量成员命名为m_，而另一个人没有这样做，那么理解代码可能需要更长时间，而如果他们都使用相同的风格，则会更容易理解）。
这就是它们（应该）要做的，所以只需拿起你现有的代码，并确保你的团队按照相同的风格编码。
我喜欢把它想象成卡通。如果你成为辛普森家庭的卡通画家，你必须以官方方式绘制眼睛，否则一切看起来都很奇怪，但是如果你去看《恶搞之家》，你必须用不同的方式绘制。两种方法都没有错。
太多的标准都是关于无意义的限制，由不编码自己的人编写（或认为自己太优秀而不遵守规范）。其他人试图教你如何编码。这两者都不适合好的标准，这些标准只是让你更容易查看某些代码并理解其工作原理。
例如，我的标准包括命名目录的规则-你的代码始终位于与项目相同名称的目录中，所有二进制文件都放在bin子目录中，所有配置文件都放在同一位置，并包含一个变更日志等。所有这些都是简单易行的事情，但我保证我永远不会找到一个名字不同、二进制文件在根目录中且我不知道所做更改的项目。这些简单而容易的事情可以带来巨大的差异。
2
我同意Harald Scheirich的观点，最重要的是让团队达成一致，而不仅仅是选择外部推荐的规则集。
我的个人建议是阅读Steve McConnell的《代码大全》第2版，其中描述了（除了其他很多有用的东西之外）几种常见的编码标准，并对每种标准提供评论。这可能会帮助你的团队制定自己的标准。
2

Lockheed Martin的JSF飞行器C++编码标准是一篇有趣的阅读材料，但除非您从事一个bug可能会致人死亡的领域，否则它有点过度。从计算机伦理的角度来看，这仍然是一个非常重要的示例，说明安全和正确性是编程的首要任务。

对于通用的C++编码，我个人推荐Herb Sutter的《C++编码规范》。从一开始，它就强调了不应该标准化什么（与风格或偏好相关的事物而不是促进安全，正确性和效率的实践）。它也是您列表中最易于阅读的书籍之一，为每个标准提供非常简洁但简明的论据，使其成为向同事展示的轻松事项。

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接