VSCode不能替代RAD Studio，但可作为Object Pascal编辑器配合FPC或Embarcadero编译器实现语法高亮、构建与基础调试，前提是路径、任务和调试符号三者对齐。
VSCode 不能直接运行 Delphi 项目，也不能替代 RAD Studio 的窗体设计器或深度调试能力；但它可以作为高效、轻量的 Object Pascal 编辑器，配合 Free Pascal（FPC）或 Embarcadero 编译器完成语法高亮、跳转、构建和基础调试——前提是路径、任务和调试符号三者对齐。
安装 Pascal 扩展并关联 .pas/.dpr 文件
VSCode 默认不识别 .pas 或 .dpr 文件，必须手动绑定语言模式。仅靠“Delphi”关键词搜索容易装错扩展（比如已停更的旧版），推荐使用维护活跃的 Pascal 扩展（作者 alefragnani）或 Modern Pascal（be5invis）。
- 安装后，在
settings.json中显式声明文件类型映射，避免 macOS/Linux 下大小写敏感导致失效："files.associations": { "*.pas": "pascal", "*.dpr": "pascal", "*.dpk": "pascal" } - 不要依赖“自动检测”，
.dpr文件若含{$APPTYPE CONSOLE}或program块，但未绑定语言，就不会触发代码补全或括号匹配 - 如果用 Embarcadero Delphi 编译器（如
dcc32.exe），扩展本身不提供其特有的strict private或class helper语义检查——这些需 Language Server 支持，而官方DelphiLSP插件要求有效许可证且仅支持 Windows
配置 tasks.json 调用编译器（FPC 或 dcc32）
构建失败最常见的原因是编译器找不到，或参数未启用调试信息。VSCode 的 tasks.json 不是万能胶，它只负责把命令丢给 shell，后续全看环境是否就绪。
- FPC 用户：确保终端中执行
fpc -i有输出，且版本 ≥ 3.2.2；在tasks.json中必须加-g（生成 DWARF）和-O0（禁用优化），否则后续调试会断点偏移或变量不可见："args": ["-g", "-O0", "${file}"] - Embarcadero 用户：
dcc32.exe必须在PATH中，或改用绝对路径（如"command": "C:\Program Files (x86)\Embarcadero\Studio\22.0\bin\dcc32.exe"）；注意-b参数在新版本中可能被忽略，建议用-Q（quiet）代替 - 别漏掉
problemMatcher，否则编译错误不会高亮到行号上："problemMatcher": ["$fpc"]
（FPC）或自定义正则匹配dcc32输出格式
用 CodeLLDB 调试 FPC 生成的可执行文件
VSCode 没有原生 Delphi 调试器，但 FPC 输出的 Mach-O（macOS）或 PE（Windows）带标准 DWARF/CodeView 符号时，CodeLLDB 或 C++ Debugger 可接管。关键不是选对插件，而是源码路径映射必须精确。
- 先验证可执行文件真有调试信息：
file ./hello应含with debug_info；llvm-dwarfdump --debug-info ./hello | head（macOS）或dumpbin /headers hello.exe（Windows）确认符号表存在 -
launch.json中的sourceMap是救命字段：若项目在/Users/me/project，但 FPC 编译时记录的路径是/private/var/folders/.../project，断点就永远不命中。最简方案是统一用相对路径编译："sourceMap": { "./": "${workspaceFolder}/" } -
miDebuggerPath在 macOS 上通常为/usr/bin/lldb，但 M2/M3 芯片需确认是否为 Rosetta 版本；Windows 用户若用 WSL2，不要试图在 VSCode for Windows 中调试 WSL 生成的 ELF 文件——得切到 WSL 环境下启动 VSCode Server
Embarcadero 编译器用户请放弃内置调试幻想
哪怕你装了 Embarcadero Delphi Debugger 扩展，它也无法连接到 dcc32 生成的 EXE。该扩展实际依赖 RAD Studio 后台的远程调试服务（dbkwsp.exe），而 VSCode 无法启动或注入该服务。你看到的“启动成功”只是进程跑起来了，但没任何调试上下文。
- 真实可行的路径只有两条：用
MSBuild+.dproj调用 RAD Studio 构建链（仍需本地装 RAD Studio），或彻底转向 FPC + CodeLLDB - 如果你的项目重度依赖 VCL 或 FireMonkey，别强求调试进 VSCode——编辑用它，编译调试回 RAD Studio，这是目前最稳的分工
- 社区版 Delphi 用户注意：
DelphiLSP插件明确不支持社区版授权，强行配置会导致401 Unauthorized错误，且无绕过方式
真正卡住人的从来不是哪行 JSON 配错了，而是编译器输出的二进制里到底有没有调试符号、符号路径和你打开的源文件路径是不是同一个 inode（Linux/macOS）或卷标（Windows）。跑通第一步前，先在终端里手动敲一遍 fpc -g -O0 hello.pas && lldb ./hello —— 如果这步都挂，VSCode 层面再怎么配都是空中楼阁。
