vscode 默认不支持 pascal 格式化，必须手动配置 pp 或 pff 路径及 language-specific 设置：右下角确认语言为 pascal，安装 alefragnani 扩展，启用 "pascal.formatter.enginepath" 和 "[pascal]": { "editor.formatonsave": true }，否则格式化将静默失败。
VSCode 默认不支持 Pascal 格式化，必须手动配置格式化器路径和参数，否则 Ctrl+Shift+I 或保存时会静默失败，连报错都不显示。
确认 Pascal 扩展已启用且语言模式正确
右下角状态栏必须显示 Pascal，而不是 Plain Text 或 Unknown。如果显示错误，点击它 → 选择 Configure Language Specific Settings → 确保 "files.associations" 中有 "*.pas": "pascal"。扩展推荐使用 alefragnani 的 Pascal（非其他同名插件），它提供基础语法高亮与括号匹配，但不含格式化能力——这点容易误判。
安装并指向外部 Pascal 格式化工具
Pascal 没有像 Prettier 那样的通用格式化器，社区主流方案是调用 pp（Free Pascal 自带的格式化工具）或第三方 pff（Pascal Formatting Filter）。FPC 3.2.2+ 版本才内置 pp，执行 fpc -i 后检查输出是否含 pp 路径。若无，需单独下载 pff 并放入 PATH。
-
pp命令示例：pp -F ${file} -O ${file}（注意：-F表示格式化，-O表示覆盖原文件） -
pff更稳定但需额外安装，Windows 下常见路径为C:\pff\pff.exe - VSCode 中通过
settings.json指定："pascal.formatter.enginePath": "pp"或完整路径
配置 language-specific 格式化选项
全局 editor.defaultFormatter 对 Pascal 无效，必须用方括号语法隔离：
"[pascal]": {
"editor.defaultFormatter": "alefragnani.pascal",
"editor.formatOnSave": true,
"pascal.format.indent": 2,
"pascal.format.spacesAfterComma": true,
"pascal.format.spacesBeforeSemicolon": false
}
其中 "pascal.format.indent" 控制缩进宽度，但实际生效依赖后端工具是否识别该参数；pp 目前只支持缩进数值，不支持空格/Tab 切换，所以 editor.insertSpaces 对它无影响。
常见失败现象与绕过方法
触发格式化后无反应、终端一闪而过、或提示 command 'editor.action.formatDocument' not found，基本可归因于以下三点：
- 未安装
pp或pff，或路径未加入PATH，VSCode 找不到可执行文件 -
tasks.json里误把构建任务当成格式化任务，二者不能混用 - 扩展版本过旧（如 v1.4.x 以下），不支持
pascal.formatter.*配置项，需升级到 v1.5.0+
临时验证方式：在终端中手动运行 pp -F test.pas，看是否生成格式化后内容。成功后再回 VSCode 配置，避免在黑盒中反复试错。
