vscode 找到 fpc.exe 的关键是将fpc.exe所在目录（如c:\fpc\3.2.2\bin\i386-win32）添加至系统path环境变量，然后在新终端运行fpc -i验证是否输出版本信息；若失败则说明路径未生效或终端未重启。
怎么让 VSCode 找到 fpc.exe？
VSCode 本身不带编译器，fpc 必须已安装且能被系统识别，否则所有后续配置都无效。
- 先在终端（cmd / PowerShell / Terminal）运行
fpc -i：有版本输出（如FPC 3.2.2）才算成功；若报“不是内部或外部命令”，说明 PATH 没设对或没新开终端 - Windows 常见路径是
C:\FPC\3.2.2\bin\i386-win32或C:\lazarus\fpc\3.2.2\bin\x86_64-win64；只把这一级目录（不含fpc.exe）加进系统 PATH 的“新建”项里 - macOS/Linux 推荐用包管理器安装（如
brew install fpc或sudo apt install fp-compiler），路径通常自动加入 PATH，无需手动干预 - 别依赖 Pascal 扩展“自动发现编译器”——它基本不读 PATH，纯靠你本地 shell 能否调用
fpc
tasks.json 里哪些参数决定能不能调试？
编译任务不是只为生成 .exe，更是为调试器准备可解析的符号信息。漏掉关键参数，断点设不上、变量显示 <optimized out></optimized> 是常态。
-
-g必须存在：启用 DWARF 调试符号生成，gdb/CodeLLDB靠它定位源码行和变量 -
-O-（大写 O + 短横）必须存在：关闭所有优化；-O0在部分 FPC 版本中等效，但-O-更通用可靠 -
${file}放最后：确保输入文件名是参数列表末尾，否则fpc可能误判为选项 - 建议加
-v：编译时打印详细路径和单元依赖，出错时一眼看出是哪个.pas文件触发的问题 - 别用
-B冲抵-O-：-B只强制重建，跟调试符号和变量可见性完全无关
launch.json 的 preLaunchTask 为什么总不执行？
这个字段不是模糊匹配，而是字符串级精确比对，大小写、空格、标点全算在内。
-
"preLaunchTask": "compile"→ 对应tasks.json中某个 task 的"label": "compile"，不能是"Compile"、"build"或"fpc-compile" - 改过
label后必须重启 VSCode：它不会热重载 task 定义，旧缓存会导致 preLaunchTask 静默失效 - 调试前先手动验证：
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选那个 label，看终端是否真能跑通编译；手动都失败，自动更不会触发 -
program字段必须指向最终生成的可执行文件：Windows 是${fileBasename}.exe，macOS/Linux 是${fileBasename}，不能漏掉后缀或写错大小写
Pascal 扩展和语言绑定容易被忽略的细节
语法高亮和跳转不是装了扩展就自动生效，尤其涉及 .dpr、.dpk 这类 Delphi 风格文件时。
- 在
settings.json显式声明映射："files.associations": { "*.pas": "pascal", "*.dpr": "pascal", "*.dpk": "pascal" }；别信“自动检测”，.dpr若没绑定，就不会触发括号匹配或Ctrl+Click跳转 - 推荐扩展是
Pascal（作者 alefragnani）或Modern Pascal（be5invis），避免使用已停更的老插件 - 如果用 Embarcadero
dcc32.exe，扩展不提供其特有语法（如strict private）的语义检查——那需要独立 Language Server，且仅 Windows 支持 - 代码导航（Go to Definition）依赖标签系统（如 GNU Global + Universal Ctags），不是 Pascal 扩展自带功能；没配好
gtags，跨文件跳转基本不可用
