需安装官方 Gleam 扩展、手动配置 Gleam 语言服务器或使用 Dev Container 三种方式启用 VSCode 中 Gleam 的语法高亮、自动补全与类型检查支持。

如果您在 VSCode 中尝试编写 Gleam 代码,但缺乏语法高亮、自动补全或类型检查支持,则可能是由于未正确配置 Gleam 语言服务器或扩展。以下是为 VSCode 启用完整 Gleam 语言支持的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装官方 Gleam VS Code 扩展
此方法通过 Visual Studio Code Marketplace 提供的官方扩展,提供开箱即用的语言功能,包括语法高亮、括号匹配、基础格式化及 LSP 集成支持。
1、启动 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Gleam,找到由gleam-lang 发布的官方扩展(名称为“Gleam”)。
3、点击“安装”按钮,等待扩展下载并启用完成。
4、重启 VSCode 以确保扩展完全加载。
二、手动配置 Gleam Language Server(GLS)
该方法绕过扩展内置的 LSP 封装,直接调用本地 Gleam CLI 附带的语言服务器,适用于需要最新诊断能力或自定义启动参数的场景。
1、确认已安装 Gleam CLI:在终端中运行gleam –version,输出应包含版本号(≥v1.16.0)。
2、在 VSCode 中打开命令面板(Cmd+Shift+P),输入并选择“Preferences: Open Settings (JSON)”。
3、在 settings.json 中添加以下配置项:
“gleam.languageServerPath”: “/usr/local/bin/gleam“,
“gleam.enableLanguageServer”: true
三、使用 Dev Container 启用完整 工具 链
此方法在隔离的 Docker 环境中部署 Gleam 编译器、GLS 及依赖管理工具,避免宿主机环境冲突,适合团队协作或 CI 一致性验证。
1、在项目根目录创建 .devcontainer/devcontainer.json 文件。
2、在该文件中指定基于 Erlang/Elixir 的镜像,并在 features 中加入 gleam-lang/gleam 安装指令。
3、在 VSCode 中按Cmd+Shift+P,输入“Dev Containers: Reopen in Container”并执行。
4、容器启动后,确认状态栏右下角显示 Gleam (via GLS) 且无错误提示。