必须先确认Free Pascal编译器已安装且fpc命令可在终端执行，否则所有配置无效；需运行fpc -v验证版本，若报错则须检查PATH或重装并勾选“Add to PATH”选项。
确认 Free Pascal 编译器已正确安装并可调用
没装 fpc 或它不在 PATH 里，后续所有配置都白搭。打开命令行（CMD/PowerShell/Terminal），直接运行：fpc -v。如果报错 'fpc' 不是内部或外部命令，说明编译器没装或路径没配对。
Windows 用户推荐安装 Free Pascal 官方 Windows 版本（带 IDE 的完整包即可，不用单独折腾 MinGW）。安装时勾选「Add FPC to system PATH」——这是最关键的一步，别跳过。
- 装完后重启终端，再试
fpc -v，应输出类似FPC 3.2.2的版本信息 - 若仍失败，手动把
fpc所在目录（如C:\FPC\3.2.2\bin\i386-win32）加进系统环境变量PATH - macOS/Linux 用户可用
sudo apt install fpc（Ubuntu/Debian）或brew install fpc（macOS），然后验证fpc -i
创建 Pascal 语法高亮与 Build System 配置文件
Sublime 默认不识别 .pas 文件，也不懂怎么调 fpc。需要两步：启用语法着色 + 告诉它如何编译运行。
先解决高亮：打开 Preferences → Browse Packages…，进入 Installed Packages 目录，下载 Pascal 插件 的 .sublime-package 文件，直接丢进去。重启 Sublime，新建文件 → View → Syntax → Pascal，确认关键词变色。
再配构建系统：菜单栏 Tools → Build System → New Build System…，粘贴以下内容并保存为 Pascal.sublime-build（注意扩展名）：
{
"cmd": ["fpc", "${file}", "-o${file_path}/${file_base_name}.exe"],
"file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:?(.*)$",
"working_dir": "${file_path}",
"selector": "source.pascal",
"variants": [
{
"name": "Run",
"cmd": ["cmd", "/c", "start", "cmd", "/c", "${file_path}/${file_base_name}.exe & pause"],
"shell": true
}
]
}
-
selector必须是source.pascal，否则按Ctrl+B时 Sublime 不会触发这个构建系统 - Windows 下
Run变体用cmd /c start cmd /c … & pause是为了弹独立窗口并停留，方便看输出；Linux/macOS 应改用bash -c "./${file_base_name} ; read -p 'Press Enter...'" - 如果代码含中文字符串，编译时报
Invalid character，需在cmd行末尾加-FcUTF8参数（即fpc -FcUTF8 ${file} -o...）
测试文件命名与保存路径影响执行结果
Sublime 构建系统里大量使用 ${file}、${file_base_name} 这类变量，它们依赖文件是否已保存、路径是否含空格或中文。
- 务必先保存文件（
Ctrl+S），扩展名必须是.pas，否则selector不匹配，Ctrl+B会静默失败 - 路径中含空格（如
C:\My Projects\hello.pas）会导致fpc解析错误；含中文（如测试.pas）在 Windows 默认编码下大概率编译失败 - 建议把文件存到纯英文无空格路径，例如
D:\pascal\hello.pas，再执行构建 - 运行时生成的
.exe默认和源文件同目录；若想集中管理，可把-o后路径改成固定位置，如-oD:/pascal/bin/${file_base_name}.exe
常见错误现象与对应修复点
写好 hello.pas 后按 Ctrl+B 没反应？或者弹窗一闪而过？先看输出面板（Ctrl+`）里有没有报错文字，而不是靠肉眼盯黑窗口。
- 输出面板显示
[WinError 2] 系统找不到指定的文件→fpc没进PATH，回第一步检查 - 提示
hello.pas(1,1) Fatal: Can't find unit system used by hello→fpc安装不完整，重装官方完整版 - 编译成功但
Run变体报错系统找不到指定的文件→ 检查${file_path}/${file_base_name}.exe是否真生成了，路径是否被杀毒软件拦截 - 中文输出乱码（如显示 □□□）→ 不是 Sublime 问题，是 Windows 控制台默认编码非 UTF-8；要么改控制台属性（右键标题栏 → 属性 → 字体选 Lucida Console + 代码页设为 65001），要么改用外部终端运行（把
Run的cmd /c start换成explorer.exe shell:appsFolder\Microsoft.WindowsTerminal_8wekyb3d8bbwe!App）
最常被忽略的是：构建系统保存位置不对。必须存进 Packages/User/ 目录（可通过 Preferences → Browse Packages… 进入），否则 Sublime 根本读不到它。
