问题描述

当前的场景是：
WordPress 运行在 Docker 中（由 wp-env 管理）。
VS Code 只打开了主题目录（工作空间范围有限）。

用 wp-env 启动 WordPress（运行在 Docker 中），VS Code 只打开了主题目录，然后执行 npm run start，同时 PHP 文件里的 WordPress 函数有错误提示。

原因：

VS Code 中用于 PHP 代码提示的插件（如 PHP Intelephense），需要 “知道 WordPress 核心函数的定义”（比如 register_block_type()、add_action() 这些函数在哪里声明），才能正确提供补全、避免 “未定义函数” 的错误提示。
鉴于我当前场景：
此时，PHP 插件的 “感知范围” 仅局限于主题内的文件，无法找到 WordPress 核心（或相关依赖）中这些函数的定义，所以会误报 “函数未定义” 的错误提示。

解决：.vscode/settings.json 中添加配置

以 PHP Intelephense 为例，可在项目的 .vscode/settings.json 中添加配置，指定 WordPress 核心的路径

添加 PHP Intelephense 配置如下：

{
    "intelephense.environment.includePaths": [
        // 直接填写你的 WordPress 核心 wp-includes 目录的绝对路径
        "C:\\project\\wordpress\\wordpress-6.8.2\\wp-includes",
        // 同时同步添加 wp-admin 目录（如果需要）
        "C:\\project\\wordpress\\wordpress-6.8.2\\wp-admin"
    ]
}

此时 PHP 插件（如 PHP Intelephense）就能识别到 WordPress 核心函数，错误提示会消失。