如何为VS Code的Xdebug添加.theme/.module等非PHP扩展名支持？

当然可以添加这类扩展名的支持，只需从VS Code调试配置、PHP语言关联、Web服务器解析规则三方面调整：

1. 让VS Code识别Drupal特殊扩展名文件为PHP #

打开VS Code设置（快捷键Ctrl+,），搜索files.associations，添加以下配置：

"files.associations": {
    "*.module": "php",
    "*.theme": "php",
    "*.inc": "php"
}

2. 调整VS Code调试配置文件 #

在项目的.vscode/launch.json中，确保路径映射正确，并保留Xdebug的基础配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/你的服务器网站根目录路径": "${workspaceFolder}"
            },
            "runtimeArgs": [
                "-d", "extension=xdebug.so",
                "-d", "xdebug.mode=debug"
            ],
            "env": {
                "PHP_IDE_CONFIG": "serverName=localhost"
            }
        }
    ]
}

3. 配置Web服务器解析规则 #

确保服务器将这些扩展名的文件当作PHP脚本处理：

Apache环境 #

在httpd.conf或虚拟主机配置中添加：

AddType application/x-httpd-php .php .module .theme .inc

Nginx环境 #

在server块的location规则中修改：

location ~ \.(php|module|theme|inc)$ {
    fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 根据你的PHP版本调整路径
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

4. 验证Xdebug核心配置 #

检查php.ini中的Xdebug参数是否正确：

xdebug.mode = debug
xdebug.client_host = localhost
xdebug.client_port = 9003
xdebug.start_with_request = yes

完成以上操作后，重启VS Code和Web服务器，即可在Drupal的.theme/.module文件中正常设置断点调试。

内容的提问来源于stack exchange，提问作者ClodClod91