Sublime需手动配置OCaml环境：安装OCaml及OPAM后，用Package Control装OCaml插件并设语法；配置Build System调用ocamlc；通过LSP插件配ocamllsp（需项目含dune文件）实现补全跳转；确保PATH含编译器且语法scope为source.ocaml。
Sublime 能跑 OCaml，但默认啥都不支持——语法高亮、编译、补全、跳转，全得手动配。不装插件、不设构建系统、不启 LSP，写出来的 .ml 文件就是纯文本。
怎么让 .ml 文件有语法高亮
没高亮 = 看不清结构，尤其 OCaml 的 let/in、match 缩进和分号逻辑容易误判。Sublime 默认不认 .ml 后缀。
- 用
Package Control安装OCaml插件（名字就叫OCaml，不是OCaml Syntax或其他变体） - 安装完重启 Sublime，或手动切换语法：右键编辑器 →
Set Syntax → OCaml - 如果仍不生效，检查文件后缀是否为
.ml（不是.mlt、.mli等），.mli需额外确认插件是否支持接口文件高亮 - 部分旧版插件对
let%bind、ppx 衍生语法支持弱，高亮可能断在%处——这不是你写错了，是语法定义没更新
为什么按 Ctrl+B 没反应或报 command not found
Sublime 不自带编译器，ocamlc 或 ocamlopt 必须在系统 PATH 里能直接调用，否则构建系统形同虚设。
- 先在终端运行
ocamlc --version和opam switch show，确认 OCaml 已安装且当前 switch 激活 - Windows 用户若用 WSL，别在 Windows 版 Sublime 里试图调用 WSL 的
ocamlc——路径不通，必须用 WSL 版 Sublime（如通过code .启动的 VS Code for WSL 才行；Sublime 无官方 WSL GUI 支持） - macOS 用户若用 Homebrew 安装，确保
eval $(opam env)已加入 shell 配置（如~/.zshrc），否则 Sublime 启动时读不到 OPAM 环境 -
shell_cmd中的引号必须严格匹配：Windows 用双引号，Linux/macOS 也建议统一用双引号包裹"${file}"，避免空格路径崩掉
ocamllsp 启动失败或没提示，LSP 设置白配
LSP 是 OCaml 在 Sublime 里获得类型提示、跳转定义、错误实时标红的核心，但 ocamllsp 不是装上就灵，它极度依赖项目结构。
- 必须在项目根目录存在
dune文件（哪怕只有(lang dune 3.7)一行），否则ocamllsp启动后立即退出，LSP 插件日志里只显示 “server exited” -
LanguageClient或LSP插件配置中，"command"值应为["ocamllsp"]，不是["opam", "exec", "--", "ocamllsp"]——后者是旧做法，新版ocamllsp已内置 OPAM 环境感知 - 检查
"scopes"是否为["source.ocaml"]，不是["source.ml"]或["OCaml"]，拼错就无法绑定 - 首次启动 LSP 可能卡住几秒，别急着关——它在解析
_build/和vendor/，期间 CPU 占用高属正常
构建系统选 Compile & Run 却看不到输出
OCaml 编译生成的是原生可执行文件，不是解释执行，./$file_base_name 运行后若没 print_endline 或类似输出，终端窗口一闪而过，你以为没跑。
- 在代码末尾加一句
let () = print_endline "done"，确认程序真执行了 - Windows 下 Sublime 的
Run变体默认用 CMD，输出窗口关闭太快；改用shell_cmd调用cmd /k或 PowerShell 的-NoExit参数 - Linux/macOS 若用
shell: true，确保"cmd"数组里没混用sh -c和直接命令——前者要写成字符串，后者是数组，混用会导致语法错误 - 更稳的做法：构建系统只负责编译，运行单独开终端（如 iTerm2 / Terminal.app），用
./a.out手动跑，方便看 stderr
真正卡住人的从来不是某一步配错，而是 opam 环境、dune 项目、Sublime 插件三者版本不齐——比如 ocamllsp 1.12 要求 dune 3.10+，但旧教程教装 dune 2.x，结果 LSP 直接静默失败，连日志都不吐一行。
