在PHP文件中键入/ ** /

Question

我使用/**/作为提交前需要解决的代码位的个人标记。一旦我输入这个：

/**

...编辑认为我想要一个docblock并触发自动完成：

/**| */

...其中|是光标。因此，当我输入最终的斜线时，我最终得到的是：

/**/| */

安装了几个PHP扩展（包括PHP DocBlocker和Felix Becker的PHP扩展包）以及--disable-extensions时会发生这种情况，因此必须由内置自动完成触发。

我可以调整设置以防止这种情况吗？

Answer 1

你应该使用

// TODO some_description_of_what_to_do 

或

/** TODO some_description_of_what_to_do */

这是标记某事的常用惯例。

哟可以省略描述部分，只需将其标记为

// TODO* 
// or 
/** TODO */

大多数IDE（肯定是PhpStorm）会突出显示这样的评论，你将能够更好地看到它。当您通过IDE提交以在提交之前检查TODO标记时，还有一个选项。

试试吧，你会注意到它有多方便;）

P.S。：如果您使用的是Visual Studio代码https://marketplace.visualstudio.com/items?itemName=wayou.vscode-todo-highlight

Answer 2

据我所知，该功能如何运作，并且没有setting来调整甚至禁用它。因此，我打开了一项功能请求：#51047 autoClosingPairs are too aggressive。 （autoClosingPairs涉及，因为它的处理方式与括号相同。）

作为解决方法，我已经创建了一个自定义代码段：

"/**/": {
    "prefix": "/**/",
    "body": "/**/",
    "description": "Workaround to be able to type /**/"
}

我只需要小心并键入 / + 输入（或 / 和 Tab ）但是一次你已经习惯了，它实际上节省了时间。