<p>VSCode 运行 Pascal 需手动配置 fpc：先确保终端可执行 fpc -i，再在 tasks.json 中添加 -g 和 -O- 参数生成调试信息，launch.json 的 program 必须严格匹配输出文件名，且修改配置后需重载窗口生效。</p>
VSCode 不能直接运行 Pascal 代码——它必须调用你本地安装的 fpc，且 tasks.json 和 launch.json 配置稍有偏差，就会编译失败、调试断点不生效、变量显示为 <optimized out>。
确认 fpc 已正确安装并能被终端识别
这是所有后续操作的前提。VSCode 不自带编译器，也不自动扫描系统目录；它只执行你写的命令，而命令能否跑通，全看终端里 fpc 是否可用。
- 打开终端（不是 VSCode 内置终端，而是全新启动的 Terminal / cmd / PowerShell），运行
fpc -i - 成功返回类似
FPC 3.2.2的版本信息，说明已就位；若报command not found或不是内部或外部命令，需检查 PATH - Windows 用户常见路径是
C:\FPC\3.2.2\bin\i386-win32或C:\lazarus\fpc\3.2.2\bin\x86_64-win64，添加时只填到bin目录层级，不要带fpc.exe - macOS 用户常用
brew install fpc，装完后通常自动加入 PATH；若手动安装，检查/usr/local/bin/fpc是否存在 - 改完 PATH 后务必新开终端验证，VSCode 也不会自动继承旧终端环境
tasks.json 必须含 -g 和 -O- 才能调试
只写 fpc ${file} 能生成可执行文件，但无法调试：缺调试符号，变量不可见，断点错位。调试依赖的是编译器输出的 DWARF 信息（macOS/Linux）或 CodeView（Windows），而这需要显式开启。
-
"args": ["-g", "-O-", "${file}"]是底线配置：-g输出调试符号，-O-关闭所有优化（注意是大写字母 O 加短横，不是数字 0） - 顺序无关紧要，但
-g和-O-缺一不可；-O0在部分 FPC 版本中等效，但-O-更通用、更稳妥 - 别信“扩展自动加参数”——Pascal 扩展几乎不干预构建逻辑，它们只管语法高亮
- 建议加
-v（verbose）：出错时能看到具体哪个单元加载失败，比默认静默输出有用得多 -
label字段（如"label": "build"）必须和launch.json中的preLaunchTask完全一致，包括大小写和空格
launch.json 的 program 必须匹配实际输出名
FPC 默认把 hello.pas 编译成 hello（macOS/Linux）或 hello.exe（Windows）。VSCode 调试器不会自动补后缀，也不会猜路径——写错一个字符，就会报 “unable to launch program” 且无明确提示。
- 确保
tasks.json编译后生成的文件名，与launch.json中"program": "./hello"或"program": "./hello.exe"严格一致 - macOS 推荐用
CodeLLDB扩展 +lldb；Windows 可用CodeLLDB（通过 WSL）或原生gdb（需额外装 MinGW-w64） -
sourceMap很关键：如果项目不在根目录下，或源码路径含中文/空格，需显式映射，例如{"./src/": "${workspaceFolder}/src/"} - 修改
launch.json后，务必重启 VSCode——它不热重载调试配置 - 调试前先手动运行一次任务：
Ctrl+Shift+P → Tasks: Run Task → 选你的 label，确认终端真能编译成功，再点 ▶️ 调试
Pascal 扩展只是语法助手，不负责编译逻辑
装了 Pascal（alefragnani）或 Modern Pascal（be5invis）这类扩展，你才能对 .pas 文件做跳转、补全、括号匹配；但它不参与构建流程，也不读取 fpc 路径，更不会帮你写 tasks.json。
- 扩展安装后，需在
settings.json中手动绑定文件类型："files.associations": {"*.pas": "pascal", "*.dpr": "pascal"} - 不加这行，新建
hello.pas可能被识别为纯文本，没有语法高亮，也无法触发任何 Pascal 相关功能 - Delphi 风格语法（如
strict private、class helper）不受支持——FPC 编译器本身不认这些，扩展更不会模拟 Embarcadero 的语义分析 - 想用代码片段？扩展自带
program、unit等基础模板，但得先确保语言模式已激活（右下角状态栏显示 “Pascal”）
最容易被忽略的是：每次改完 tasks.json 或 launch.json，都必须重载 VSCode 窗口（Ctrl+Shift+P → Developer: Reload Window），否则新配置不生效——这不是 bug，是 VSCode 的设计行为。
