security - 危险代码片段应该如何发布？

Question

在讨论(提出/回答问题、撰写博客文章等)某些编程问题时，可能需要提供所讨论内容的源代码示例；但在某些情况下，这些片段可能是危险的，不是因为它们直接有害，而是因为它们一开始似乎有效，但只是为以后的问题而设置。两个例子是在讨论并发问题时，代码在大多数情况下都可以工作，但很少且不确定地失败；在讨论安全问题时，代码似乎可以工作，但实际上可以被利用；可能还有其他例子。

有必要能够讨论这些问题，至少提高人们对这些问题的认识。然而，我总是担心有人会从搜索引擎来，几乎没有阅读帖子，复制并粘贴代码片段并将其用于某些目的；更巧妙的是，有人可能会阅读这篇文章，在测试项目中尝试代码并确认它确实可以被利用(正如他被鼓励这样做的那样)，然后一段时间后重用危险代码，因为他忘记了代码是危险的并且不再有博客文章解释为什么代码片段周围的代码是危险的。

所以我想知道如何标记这样的代码，以便它的任何部分都不会以某种方式进入生产(或者如果有的话，那么责任方不能合理地否认意识到)。

我想出的一种方法是:

1. 每个函数内的#error(或类似)指令，以及
2. 重复评论警告代码的危险性(因为在测试项目中尝试代码以确认问题的人将删除 #error 指令)。

但是，由于这些评论只会在网络上阅读时使代码片段变得困惑，因此我将它们设置为与背景相同的颜色(或者至少我正在尝试这样做；看看我如何将其付诸实践 here ，我顺便说一句a question on doctype.com 询问如何最好地做到这一点)。

如果这看起来完全矫枉过正，请记住并发(和安全)问题非常危险，因此我想尽我所能(在合理范围内)防止我的代码片段在实际软件中引起问题；我有时将其与裂变 Material 处理进行比较。

(老实说，我不知道它是否最适合programmers.stackexchange.com或这里，所以我首先在这里问；如果事实证明它是这样，请随意转到programmers.stackexchange.com那里更好。)

Answer 1

你的观点非常好，我认为你现在处理得很好。然而，#error 行出现在我的博客文章中，它们不是白色的。

我认为您不必太担心它会被提要或类似的东西获取。如果代码从博客上的警告消息中删除，则更重要的是让 #error 行可见。

但总的来说，我喜欢你的系统。不过，作为程序员，为此设定一些标准可能是个好主意。不过，我也会在原始帖子中添加一个链接，解释为什么它也很糟糕。这比仅仅说出来更重要。

总结一下:好主意，我们应该想一个标准。确保包含一个指向原因的链接。