应安装官方ReScript扩展、配置rescript.json、重启语言服务器、手动指定rescript-cli路径、禁用冲突的ReasonML扩展。
如果您在使用 VSCode 进行 ReasonML 或 ReScript 开发时遇到类型提示缺失、语法高亮异常或编辑器无法识别模块依赖等问题，则可能是由于语言服务器未正确配置或扩展支持不完整。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装官方推荐扩展
ReScript 官方维护的 VSCode 扩展提供完整的语言服务支持，包括类型推导、跳转定义、实时错误检查等功能，其底层依赖于 ReScript 的 language server（rescript-langserver）。
1、打开 VSCode 的扩展市场（快捷键 Cmd+Shift+X）。
立即学习“前端免费学习笔记（深入）”；
2、搜索 ReScript 并选择由 rescript-langserver 团队发布的官方扩展。
3、点击“安装”，安装完成后重启 VSCode。
二、配置 rescript.json 与项目结构
VSCode 的 ReScript 支持依赖项目根目录下存在有效的 rescript.json 配置文件，该文件定义了编译目标、源码路径及依赖映射关系，是语言服务器识别项目上下文的基础。
1、确认项目根目录中已存在 rescript.json 文件。
2、检查其中 "sources" 字段是否包含正确的 src 路径，例如：{"dir": "src", "subdirs": true}。
3、确保 "package-specs" 中的 "module" 和 "in-source" 设置与实际构建流程一致。
三、启用并验证语言服务器状态
ReScript 扩展通过后台运行的 rescript-langserver 提供类型信息，若服务器未启动或崩溃，编辑器将失去所有类型感知能力。
1、打开命令面板（Cmd+Shift+P），输入并选择 ReScript: Restart Language Server。
2、观察 VSCode 右下角状态栏，确认显示 ReScript Ready 状态。
3、在 .res 或 .resi 文件中将光标悬停于任意变量名上，验证是否弹出含类型签名的 tooltip。
四、手动指定 rescript-cli 路径
当项目使用 pnpm 或自定义 bin 目录管理依赖时，VSCode 可能无法自动定位本地安装的 rescript CLI，导致语言服务器初始化失败。
1、在 VSCode 设置中搜索 ReScript: Executable Path。
2、点击“Edit in settings.json”，添加如下字段："rescript.executablePath": "./node_modules/.bin/rescript"。
3、若使用 pnpm，路径应为："./node_modules/.pnpm/rescript@latest/node_modules/rescript/bin/rescript"。
五、禁用冲突的语法扩展
部分第三方 ReasonML 扩展（如旧版 Reason 插件）会与当前 ReScript 扩展产生协议冲突，干扰语言服务器通信，造成类型提示延迟或完全失效。
1、在扩展列表中查找名称含 Reason、OCaml 或 Merlin 的非官方插件。
2、对每个疑似冲突扩展，点击“禁用”按钮。
3、重启 VSCode 后重新打开 .res 文件，观察类型提示是否恢复即时响应。
