必须先确保系统终端能执行 swipl --version；否则 vscode 插件、任务、终端命令全失效。仅安装官方 vscode-swi-prolog 插件，配置 tasks.json 运行任务，调试依赖 swipl 交互命令而非图形断点。
swipl 命令行不可用，VSCode 就根本跑不动 Prolog——所有“运行”动作都只是调用它，没它，插件、任务、终端命令全瘫痪。
确认 swipl 能在系统终端直接执行
这是唯一前提，跳过这步后面全白忙。
- 打开系统终端（不是 VSCode 内置终端），运行
swipl --version - 必须返回类似
SWI-Prolog version 8.4.3；若报'swipl' is not recognized或command not found，说明 PATH 没配好 - Windows 用户检查安装时是否勾选了 “Add SWI-Prolog to the system PATH”；没勾就手动把
C:\Program Files\swipl\bin\swipl.exe加进系统环境变量 - macOS/Linux 用户确认
/usr/local/bin/swipl或/usr/bin/swipl存在且可执行（ls -l $(which swipl)看权限） - 别信插件能“自动找 swipl”——它只调
swipl命令，不修 PATH，也不猜路径
只装 swi-prolog.vscode-swi-prolog 插件，别碰其他“Prolog”
Marketplace 上名字带 Prolog 的插件有七八个，但只有这个官方插件支持模块语法、加载 library/、提供语义诊断。
- 搜
vscode-swi-prolog，认准发布者是swi-prolog - 装完后打开任意
.pl文件，右下角语言模式应显示Prolog；若仍是Plain Text或Perl，点击它手动选，或在settings.json加："files.associations": {"*.pl": "prolog"} - 状态栏出现
[SWI-Prolog]且 hover 能看到版本号，才算语言服务器（LSP）真正跑起来了 - 其他插件（如
prolog作者 mrc32）连:- use_module(library(http/http_dispatch)).都标红，别浪费时间试
用 tasks.json 定义运行任务，F5 和 launch.json 是无效的
VSCode 内置调试器不理解 Prolog，vscode-swi-prolog 插件也不响应 type: "prolog" 这类配置——那是过时插件留下的伪配置。
- 在项目根目录建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-prolog",
"type": "shell",
"command": "swipl",
"args": ["-g", "main", "-t", "halt", "-s", "${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
-g main 表示执行 main/0 谓词；没定义 main/0 就会报错，可换成你自己的入口谓词名-t halt 是防止解释器卡在交互模式；漏掉它，任务看似“完成”，其实 swipl 还在等你输查询Ctrl+Shift+P → “Tasks: Run Task” → 选 run-prolog，或绑定快捷键调试只能靠 swipl 自带的 trace/0，VSCode 没图形断点
没有单步、没有变量监视面板、没有 F9 断点——Prolog 的调试逻辑和 Python/JS 完全不同，得进 swipl 交互环境手动开。
- 想调试，先确保你的代码里有
trace.或运行时加参数：swipl -g trace -t halt -s ${file} - 更常用的是组合：
swipl -g "leash(-all), trace, main" -t halt -s ${file}，这样一进就开全跟踪 + 全拦截 - 如果 LSP 不加载
~/.swiplrc（默认不加载），而你又依赖自定义路径（比如asserta(user:file_search_path(mylib, '/path'))），就得在插件设置里填swipl.args数组，例如：["-f", "/path/to/my_init.pl"] - 别指望“运行”按钮自动帮你做对事——它只负责敲命令，怎么调试、怎么设断点、怎么查变量，全得你自己在
swipl提示符下输指令
真正麻烦的不是配置，而是接受 Prolog 在 VSCode 里“没有调试器”这件事：它不缺功能，只是方式完全不同。你得习惯在终端里打 leash(on)、skip、fail，而不是点鼠标。
