Sublime Text 默认不识别 .cl 文件，需手动安装 opencl.sublime-syntax 并绑定扩展名；即使装了名称相似插件，若不含语法定义，__kernel 等关键字仍无高亮，且必须确认配色方案支持 storage.modifier.address-space.opencl 等 scope。
Sublime Text 默认不加载 OpenCL C 语法，.cl 文件打开就是 Plain Text，装插件≠有高亮，必须手动绑定语法文件和扩展名。
为什么 .cl 文件全是灰色？不是插件没装，是语法根本没加载
Sublime Text 原生不带 opencl.sublime-syntax，Package Control 里搜 “OpenCL”“CL”“Kernel” 出来的多数只是 snippets 或构建命令，不含真正的语法定义。哪怕你装了名字像的插件，__kernel、get_global_id()、barrier() 这些关键字照样不着色——因为 Sublime 根本没识别出这是 OpenCL C。
- 打开 .cl 文件右下角显示
Plain Text，就是最直接的证据 - 别在 Package Control 里反复重装“OpenCL”类插件，99% 情况下它们不提供
.sublime-syntax - 唯一实测在 ST4（build 4143+）下稳定工作的语法文件来自 GitHub 项目
sublime-opencl（作者 kubkon）
手动安装 opencl.sublime-syntax 并绑定 .cl 扩展名
这一步不能跳过，且顺序不能错：先放文件，再重启，再手动选语法，最后设默认关联。
- 下载最新
opencl.sublime-syntax：访问 该链接，解压后取到该文件 - Preferences → Browse Packages… → 进入
User目录（不是Installed Packages） - 把
opencl.sublime-syntax直接粘贴进User文件夹 - 重启 Sublime Text，打开任意
foo.cl，点击右下角Plain Text→ 选择OpenCL - 再点一次右下角 →
Open all with current extension as…→OpenCL，此后所有 .cl 文件自动生效
高亮有了但 __kernel 还是灰的？查 scope 和配色方案映射
语法加载成功 ≠ 颜色可见。比如 __kernel 显示为 storage.modifier.address-space.opencl，但当前主题没给这个 scope 设颜色，它就还是灰的。
- 按
Ctrl+Shift+P输入Developer: Show Scope Name，把光标停在__kernel上，看状态栏是否显示对应 scope - 如果 scope 正确但颜色不对，换一个主题试试（如
Brogrammer），确认是不是当前主题缺失规则 - 要长期修复：编辑你当前的
.sublime-color-scheme文件，在"rules"数组末尾加一条：{"scope": "storage.modifier.address-space.opencl", "foreground": "#007acc"} - 注意：
foreground必须是合法颜色值（#rrggbb、hsl()、hsla()），写错整条规则会静默失效
常见错误：装完就以为完事，结果 build 失败或函数不补全
语法高亮只是第一步。OpenCL 开发真正卡住的地方常在后续环节：
-
clGetPlatformIDs调不通？别急着配 Sublime，先在终端跑clinfo，没这个命令说明 OpenCL 运行时根本没装对 - VSCode 里
#include <CL/cl.h>标红？问题不在编辑器，而在系统层：AMD 用户检查%AMDAPPSDKROOT%\include\CL\，NVIDIA 用户找 CUDA Toolkit 的include\CL\，Intel 用户看 oneAPI 路径 - 想用
cl::Platform::get()却返回空？先用纯 C 版本验证底层通不通，C++ 绑定库容易因链接顺序或 DLL 加载失败而静默挂掉
语法文件放对位置、扩展名绑对、scope 映射对，三者缺一不可。最容易被忽略的是第三步——很多人看到右下角变成 OpenCL 就以为搞定了，结果写了一百行 __local 还是灰的，其实是配色方案根本没管这个 scope。
