VSCode 本身不运行 Prolog 代码，真正执行依赖本地 swipl 进程；必须先安装 SWI-Prolog 并确保终端中 swipl --version 可正常返回版本号，否则插件、任务、终端命令全部失效。
VSCode 本身不运行 Prolog 代码，它只负责编辑和触发外部命令；真正执行靠的是你本地安装的 swipl 进程。没装 SWI-Prolog 或路径配错，点再多次 F5 都不会输出 “Hello World”。
确认 swipl 命令行可用是前提
这是所有后续配置生效的基础。VSCode 的 Prolog 插件、任务、终端命令全依赖这个可执行文件。
- 打开系统终端（cmd / PowerShell / Terminal），输入
swipl --version，必须返回类似SWI-Prolog version 8.4.3的结果 - 如果报错
'swipl' is not recognized，说明没加进 PATH：Windows 用户检查安装时是否勾选了 “Add SWI-Prolog to the system PATH”；macOS/Linux 用户确认/usr/local/bin/swipl或/usr/bin/swipl是否存在 - 路径不对会导致插件语言服务器启动失败（状态栏卡在 [SWI-Prolog] Starting）、
tasks.json执行报spawn swipl ENOENT、终端里也跑不了swipl -gmain file.pl
用 tasks.json 定义运行任务（最稳）
VSCode 内置调试器不支持 Prolog，所谓 “F5 运行” 实际是调用一个预定义的 shell 任务。别信某些教程里瞎写的 "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谓词；没定义会报ERROR: Undefined procedure: main/0 -
-s ${file}是加载当前打开的.pl文件；注意不是${fileBasename}，后者不含路径，swipl 找不到文件 - 按
Ctrl+Shift+P→ 输入 “Tasks: Run Task” → 选run-prolog即可运行；也可绑定快捷键
语言模式和高亮失效？先看文件关联
如果你打开 hello.pl，右下角显示 “Plain Text” 或 “Perl”，那语法高亮、括号匹配、Ctrl+Click 跳转全失效——这不是插件坏了，是 VSCode 根本没把它当 Prolog 文件处理。
- 点击右下角语言模式，手动选 “Prolog”（临时解决）
- 一劳永逸：在
settings.json加这行："files.associations": {"*.pl": "prolog"} - 别装错插件：只认
swi-prolog.vscode-swi-prolog（发布者是swi-prolog）；其他叫 “Prolog” 的插件（如mrc32.prolog）不支持模块语法、无 LSP、高亮漏判注释 - 插件安装后不用重启，但若已打开
.pl文件，需重新打开或重载窗口（Ctrl+Shift+P→ “Developer: Reload Window”）
调试只能靠 swipl 自带 trace，别指望断点面板
vscode-swi-prolog 插件不提供图形化调试界面。所谓“调试”，实际是启动一个交互式 swipl 会话，然后手动输 trace.、leash(on).、nodebug. 等命令。
- 写个测试谓词，比如
fib(0, 0). fib(1, 1). fib(N, F) :- N > 1, N1 is N-1, N2 is N-2, fib(N1, F1), fib(N2, F2), F is F1 + F2. - 在终端运行
swipl -s fib.pl进入交互环境，再输trace.→fib(5, X).就能看到每一步调用栈 - 想从 VSCode 启动交互会话？在
tasks.json里加个新 task："command": "swipl", "args": ["-s", "${file}"]，去掉-g和-t - 别试图在
launch.json里配 Prolog 调试器——没有标准协议支持，微软也没实现，所有声称能 F5 断点的方案都是套壳 shell 任务
最容易被忽略的一点：插件的语言服务器（LSP）默认不加载你的 ~/.swiplrc 或自定义库路径。如果用了 :- use_module(library(http/http_dispatch)). 却提示找不到模块，得在插件设置里填 swipl.args，例如 ["-f", "/path/to/my_init.pl"] —— 这个 init 文件里再写 asserta(user:file_search_path(...)) 才行。
