Intelephense格式化工具在PHP/HTML中自动添加空行的解决方案

2025-07-09 15:08:58作者：伍霜盼Ellen

问题背景

在使用VSCode的Intelephense插件进行PHP/HTML代码格式化时，许多开发者会遇到一个常见问题：插件会在HTML文档的<html>、<head>和<body>标签之间自动添加额外的空行。虽然这种格式化风格在某些情况下可能提高可读性，但对于遵循特定代码风格指南或偏好紧凑格式的开发者来说，这可能不符合他们的需求。

技术原理

Intelephense插件实际上内置了js-beautify工具来处理HTML部分的格式化工作。js-beautify是一个流行的JavaScript代码美化工具，同时也支持HTML和CSS的格式化。该工具默认会在特定的HTML标签前后添加空行，这是其预设的格式化规则之一。

解决方案

要解决这个问题，我们可以在项目根目录下创建一个名为.jsbeautifyrc的配置文件。这个文件允许我们自定义js-beautify的行为，覆盖其默认的格式化规则。

配置内容如下：

{
    "html": {
        "extra_liners": []
    }
}

这个配置中的extra_liners数组原本默认包含["head", "body", "/html"]等标签，表示在这些标签前后添加空行。通过将其设置为空数组，我们告诉格式化工具不要在特定标签周围添加额外的空行。

实施建议

在项目根目录创建.jsbeautifyrc文件
将上述配置内容复制到文件中
保存文件后，重新格式化你的PHP/HTML文档

注意事项

这个配置会影响项目中所有HTML文件的格式化行为
如果你同时使用其他格式化工具，可能需要检查它们是否会与这个配置产生冲突
团队开发时，建议将这个配置文件纳入版本控制，确保所有成员使用相同的格式化规则

扩展知识

除了控制空行外，.jsbeautifyrc文件还可以配置许多其他格式化选项，如缩进大小、是否保留换行符、属性换行方式等。开发者可以根据团队或个人的编码风格需求进行更细致的配置。

通过理解Intelephense背后的格式化机制并合理配置，开发者可以确保代码既保持整洁美观，又符合特定的风格要求。

vscode-intelephense

PHP intellisense for Visual Studio Code

项目地址：https://gitcode.com/gh_mirrors/vs/vscode-intelephense

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

gitea

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统