在 Xcode 中禁用“/* 块注释内”警告

Question

我在开发时经常需要多个嵌套的多线（或“部分线”）cmets。

Xcode 最近引入了可能是世界上最烦人的警告 - 它迫使我禁用“作为错误的警告”。我猜这个警告是为了捕捉极其罕见的情况，即有人拼写错误并导致块​​评论没有结束 - 但 IME 有许多其他问题会导致很快就会显示出来。

一些例子：

/* removed while debugging the BARFOO
-(void) aMethod
{
[self methodCall:7.0 /* needed to FOO the BAR: */ * self.multiplier * /* double for hi-res:*/ 2.0];
}
*/

和：

/* removed while debugging the BARFOO

/** This method has DOCUMENTATION
*/
-(void) aDocumentedMethod
{
...
}

-(void) aMethod
{
/** internally, we have to BAR BAR the FOOFOO.
1. BAR
2. BARBAR
3. Finally, FOOOFOO
*/
...complex lines of source here...
}
*/

当然还有调试时非常简单的双重注释。

但我在 Xcode5 中找不到禁用此警告的位置 - 它似乎不存在于任何列出的警告中 :( ?

Answer 1

如果要查看警告代码，请进行构建，进入“日志导航器”，选择构建，展开构建日志：

查看构建日志的详细信息后，您会看到此处列出的警告代码。在这种情况下，您会看到警告是 -Wcomment。

---

注意，这可以帮助您识别您查询的警告（“/* 块注释内”警告），但它不会改变嵌套 /* ... */ cmets 的行为。

我个人使用 Abizern 的技术来快速评论大块。或者，您可以使用

#if 0

和

#endif

（你可以嵌套）注释掉你的块时

Answer 2

您可以将// 用于任何地方的 cmets。这样您就不会收到此警告。

/也兼容doxygen类型的cmets，你不需要使用/**版本。

Xcode 支持这种语法。如果您选择一个区域，您可以使用 cmd + /

切换 cmets