必须安装官方swi-prolog.vscode-swi-prolog插件，其他Prolog插件不支持模块语法、不加载library路径、无语义诊断；.pl文件默认被识别为Perl或Plain Text，需手动设语言模式或在settings.json中配置"files.associations": {"*.pl": "prolog"}。
必须装 swi-prolog.vscode-swi-prolog 插件，其他名字带“Prolog”的插件基本不可用——它们不支持模块语法、不加载 library/ 路径、没语义诊断，连 :- use_module(library(http/http_dispatch)). 都会报红。
为什么点开 .pl 文件还是 Perl 或 Plain Text
VSCode 默认把 .pl 当作 Perl，且不会自动识别 Prolog。不手动干预，就永远是白底黑字、无高亮、无跳转。
- 临时解决：打开任意
.pl文件后，点右下角语言模式（显示Perl或Plain Text），选Prolog - 永久解决：在
settings.json里加这一行："files.associations": {"*.pl": "prolog"} - 如果仍无效，检查是否被其它插件劫持了关联（比如 Perl 插件设了更高优先级）
状态栏卡在 [SWI-Prolog] Starting 或报 spawn swipl ENOENT
插件找不到 swipl 可执行文件，本质是 PATH 没配对，或路径写错了。
- Windows 下真实路径通常是
C:\Program Files\swipl\bin\swipl.exe（注意带.exe后缀） - macOS 下一般是
/usr/local/bin/swipl；Linux 多为/usr/bin/swipl - 在 VSCode 设置中搜
swipl.executable，填**绝对路径**，不要只写swipl - 终端里先运行
swipl --version确认能输出 v8.4+，否则插件根本起不来
代码有高亮但 Ctrl+Click 跳不到定义，或模块谓词标红
插件的语言服务器（LSP）默认不读 ~/.swiplrc，所以你用 asserta(user:file_search_path(...)) 加的路径它看不见。
- 需要显式告诉插件加载初始化文件：在设置里填
swipl.args数组，例如：["-f", "/path/to/my_init.pl"] -
my_init.pl里可以写:- use_module(library(clpfd)).或自定义路径，LSP 才会识别 - 模块语法如
:- module(mylib, [...]).必须由官方插件解析，老插件直接当语法错误
最容易被忽略的是：调试不是按 F5 就能进断点的。这个插件不提供图形化调试器，trace/0 和 leash/1 得靠终端命令触发，得自己配 tasks.json 才能一键跑起来——这点和 Python、JS 完全不同，别指望“运行”按钮自动做对事。
