在VS Code的PHP中使用<code>块实现工具提示遇阻求助

DevOps 小满

2026-7-18

问题：VS Code中PHP PHPDoc的<code>标签内容未被渲染

我在VS Code的PHP环境里尝试实现PHPDoc示例代码的渲染效果，但<code>标签里的代码内容在工具提示中被忽略了。

我的代码

/**
 * 这个函数是测试用的占位函数，目前没有具体实现。
 * <example> 调用示例如下：
 * <code>
 * $this->testFunction( $baba, $booey );
 * </code>
 * 感谢查看我的示例
 * </example>
 * @param mixed $args 传递给测试函数的参数。
 */
function testFuntion($args){

}

当前工具提示效果

工具提示仅显示示例的描述文字，<code>块内的代码完全被忽略，没有格式化呈现（截图显示提示框里只有“调用示例如下：感谢查看我的示例”这类文本，看不到代码片段）。

解决方案

1. 确认标签写法与扩展支持

VS Code的PHP代码提示依赖felixfbecker.php-intellisense这类扩展，部分版本对<code>标签的支持有细节要求：

直接使用<code>标签即可，不需要转义成<code>（你的代码写法没问题）
确保<example>和<code>标签完整闭合，代码块内内容保持适当缩进

2. 改用`@example`标签+Markdown代码块

部分扩展对Markdown格式的支持更稳定，你可以替换成@example标签配合Markdown代码块：

/**
 * 这个函数是测试用的占位函数，目前没有具体实现。
 * @example 调用示例如下：
 * ```php
 * $this->testFunction( $baba, $booey );
 * ```
 * 感谢查看我的示例
 * @param mixed $args 传递给测试函数的参数。
 */
function testFuntion($args){

}