必须通过终端或tasks.json调用swipl运行.pl文件；VSCode默认识别为Perl，需手动设语言模式或配置"files.associations"；swipl路径未配置会导致启动失败；LSP不读.swiplrc，需用swipl.args指定初始化文件；无图形调试器，依赖命令行trace/leash。
不能直接点 F5 运行，必须靠终端命令或 tasks.json 调用本地 swipl；不装官方插件、不配对路径、不改文件关联，.pl 文件永远是 Plain Text。
为什么 .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 没配对，或 VSCode 设置里填错了路径。
- 先在系统终端（不是 VSCode 内置终端）运行
swipl --version，确认能输出类似SWI-Prolog version 8.4.3 - Windows 下真实路径通常是
C:\Program Files\swipl\bin\swipl.exe（注意带.exe后缀） - macOS 下一般是
/usr/local/bin/swipl；Linux 多为/usr/bin/swipl - 在 VSCode 设置中搜
swipl.executable，填**绝对路径**，别只写swipl
代码有高亮但 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, []).这类模块语法必须由官方插件解析，老插件直接当语法错误
怎么真正运行和调试 Prolog 代码
VSCode 不提供 Prolog 图形化调试器，F5 按钮无效；所谓“运行”，就是调用 swipl 命令行参数；调试只能靠 trace/0 和 leash/1 在交互式环境里手动操作。
- 最简运行：打开内置终端（
Ctrl+`），执行swipl -g main -t halt -s ${file}（假设你有main/0谓词） - 一键运行：项目根目录建
.vscode/tasks.json，command设为swipl，args填["-g", "main", "-t", "halt", "-s", "${file}"] - 别配
launch.json里的type: "prolog"—— 那是过时插件留下的伪配置，当前官方插件根本不响应 - 想单步、查变量？必须进
swipl交互式环境，手动输trace.、leash(on).，再运行目标
最容易被忽略的是：模块路径、自定义库、调试行为全依赖 swipl 启动参数，而不是 VSCode 的 UI 状态；哪怕高亮和跳转都正常，swipl.args 没配对，library(clpfd) 还是会标红，trace 也进不去你的模块谓词。
