17370845950

VS Code 默认支持 PHP 代码折叠，需确保文件语言模式为 PHP 且未禁用折叠功能；可折叠结构包括函数、类、控制语句等，也支持 #region 手动标记。

VS Code 默认支持 PHP 代码折叠，但需满足两个前提：文件被正确识别为 php 语言模式，且未禁用折叠功能。如果 Ctrl + Shift + [（Windows/Linux）或 Cmd + Opt + [（macOS）没反应，问题几乎都出在这两点。

确认当前文件语言模式是 php

VS Code 折叠能力高度依赖语言模式。即使文件后缀是 .php，若右下角状态栏显示的是 plaintext、HTML 或其他语言，折叠将失效。

• 点击右下角语言标识（如 “Plain Text”），在弹出菜单中选择 PHP
• 或按 Ctrl + Shift + P（Windows/Linux） / Cmd + Shift + P（macOS），输入 Change Language Mode，回车后选 PHP
• 也可在文件开头添加 （哪怕只有一行），帮助 VS Code 自动识别

检查是否意外禁用了折叠功能

折叠开关可能被关闭，尤其在自定义配置或安装某些插件后。

• 打开设置（Ctrl + ,），搜索 folding
• 确认 Editor: Folding 是启用状态（勾选）
• 检查 Editor: Folding Strategy —— 推荐保持默认的 auto；若设为 indentation，PHP 的大括号块将无法折叠
• 若使用了插件如 PHP Intelephense 或 PHP Tools，确保其未覆盖折叠逻辑（可临时禁用测试）

PHP 中哪些结构默认可折叠？

VS Code 基于语言服务器（如 intelephense）或内置语法分析器识别可折叠区域。以下结构在标准配置下原生支持：

• function、class、interface、trait 声明块
• if、for、foreach、while、switch 等控制结构
• /* */ 和 // 注释块（需开启 Editor: Folding Strategy 为 auto）
• 以 { 开头、} 结尾的任意代码块（包括匿名函数、数组字面量等）

注意：require/include 语句本身不可折叠，但其引入的文件内容若在当前编辑器中打开，则按该文件语言规则处理。

手动添加折叠区域（#region / #endregion）

当标准语法不满足需求（例如想折叠一段纯 HTML 混合 PHP 的模板逻辑），可用 VS Code 原生支持的自定义折叠标记：

// #region 用户权限校验逻辑
if (!isset($_SESSION['user_id'])) {
    header('Location: login.php');
    exit;
}
// #endregion

VS Code 会将 // #region 和 // #endregion 之间的内容视为一个可折叠区。注意：

• 必须使用 //（单行注释），/* */ 不生效
• 标记需独占一行，且 #region 后可加描述（如上例），#endregion 后不能跟内容
• 此方式与语言无关，但需确保 Editor: Folding Strategy 为 auto

最常被忽略的一点：PHP 文件里混写大量 echo " HTML 字符串时，VS Code 默认不会把整段字符串折叠——它只认语法结构，不认输出内容。这时候得靠 #region 手动圈定，或者重构为模板分离。