必须安装官方Pkl扩展并关联文件类型，否则无高亮；需配置pkl CLI路径、启用语义高亮，并用带.pkl后缀的精确scope自定义颜色。
VSCode 默认不支持 Pkl 语言，必须手动安装插件并配置文件关联，否则连基础高亮都不会出现——这不是设置问题，是根本没识别成 Pkl。
安装官方 Pkl 扩展并确认启用
微软官方维护的 Pkl 扩展（Pkl by pkl-lang）提供语法高亮、自动补全、类型检查和实时错误诊断。它依赖本地 pkl CLI 工具，不是纯前端插件。
- 打开扩展面板（
Ctrl+Shift+X），搜索"Pkl"，安装由pkl-lang发布的官方扩展 - 确保系统已安装
pklCLI：pkl --version能正常输出（v0.25.0+ 推荐）；若未安装，从 pkl-lang.org/download 下载对应平台二进制并加入PATH - 重启 VSCode 后，状态栏右下角应显示
Pkl语言标识，且.pkl文件自动启用高亮
强制将 .pkl 文件关联为 Pkl 语言模式
有时 VSCode 会把 .pkl 当作纯文本或 JSON 处理，导致高亮失效。不能只靠文件后缀“碰运气”，必须显式绑定。
- 打开任意一个
.pkl文件 - 点击右下角语言模式（如显示
Plain Text或JSON） - 选择
Configure File Association for '.pkl'...→ 输入Pkl并回车 - 也可在
settings.json中硬编码："files.associations": { "*.pkl": "pkl" }
启用语义高亮与类型检查（关键步骤）
仅装插件 ≠ 有类型提示。Pkl 插件的类型检查能力依赖语义高亮（Semantic Highlighting）开关和语言服务器响应，关掉就退化为普通高亮。
- 在设置中搜索
editor.semanticHighlighting，确保值为true - 检查插件是否已启动语言服务器：打开命令面板（
Ctrl+Shift+P），运行Pkl: Show Server Status，应显示Running - 若报错
Cannot find module 'pkl'，说明 CLI 未被找到，需在settings.json中指定路径："pkl.cliPath": "/usr/local/bin/pkl"（macOS/Linux）或"pkl.cliPath": "C:\pkl\pkl.exe"（Windows） - 类型检查默认开启，无需额外配置；但若想关闭实时诊断，可设
"pkl.diagnostics.enable": false
自定义 Pkl 高亮颜色时 scope 必须带后缀
想改 module 关键字颜色？直接写 "keyword" 不生效——Pkl 的 TextMate scope 是 keyword.control.pkl，漏掉 .pkl 后缀，规则就被忽略。
- 先用
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes悬停目标词，确认完整 scope（如entity.name.type.pkl、string.quoted.double.pkl） - 在
settings.json的editor.tokenColorCustomizations中按精确 scope 写规则：
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "keyword.control.pkl",
"settings": { "foreground": "#FF6B6B", "fontStyle": "bold" }
}
]
}
语义高亮（editor.semanticTokenColorCustomizations）也需同样处理，例如 "type": "#4ECDC4" 只影响类型名，但前提是 scope 真正被语言服务器标记出来——这步比 TextMate 规则更易失败，因为一旦 CLI 路径错或 server 崩溃，整个语义层就为空。
