应安装 jcberquist/sublimetext-cfml 插件，它当前维护最活跃、兼容 Sublime Text 4+，而旧版 ColdFusion 插件已停更且存在语法识别失败、cfscript 补全缺失等问题。
CFML 插件装哪个？别用 ColdFusion，选 sublimetext-cfml
当前维护最活跃、兼容性最好的是 jcberquist/sublimetext-cfml，不是旧版的 ColdFusion 插件。后者已停止更新，且在 Sublime Text 4+ 中常出现语法识别失败、cfscript 补全缺失等问题。
安装方式统一走 Package Control：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package - 等待列表加载后，搜
CFML（注意大小写和空格，别输成ColdFusion） - 选中并回车，安装完成后重启 Sublime Text
装错插件的典型表现：.cfm 文件右下角显示为 HTML 或 Plain Text，<cfoutput> 标签无高亮，cfscript 区块内变量名全白——这说明插件根本没接管语法解析。
.cfm 文件不自动高亮？检查语法绑定和文件类型识别
Sublime 不靠扩展名自动启用语法，而是依赖「当前视图的语法类型」。即使你打开的是 index.cfm，如果右下角显示的是 HTML，那所有 CFML 特性都不会触发。
手动修正步骤：
- 点击窗口右下角的语法名称（如
HTML），从弹出菜单中选择CFML - 或按
Ctrl+Shift+P→ 输入Set Syntax: CFML回车 - 若想让所有
.cfm和.cfc文件默认用 CFML 语法，需确保没有冲突的自定义映射。检查Packages/User/下是否存在HTML.sublime-settings或Text.sublime-settings，里面误写了"extensions": ["cfm"]
常见坑：CFML 语法包本身已声明对 .cfm/.cfc 的支持，无需额外配置；强行在 User 设置里加扩展名映射反而会覆盖插件逻辑，导致高亮失效。
高亮颜色不对？改的是 color_scheme，不是语法文件
CFML 插件只负责把 <cfquery>、cfloop、var 这些词标记为对应 scope（比如 keyword.control.cfml、support.function.cfml），真正决定颜色的是你当前启用的配色方案（color_scheme）。
验证和修复流程：
- 光标放在一个
<cfif>标签上，按Ctrl+Shift+P→ 输入Show Scope Name回车，看状态栏是否显示类似keyword.control.cfml的 scope —— 这说明语法识别正常 - 再看右下角提示的
color_scheme路径，如果是Packages/xxx/xxx.sublime-color-scheme（不含User/），说明你在编辑只读主题，改了也无效 - 正确做法：把原主题文件复制到
Packages/User/下（如重命名为MyCFMLTheme.sublime-color-scheme），然后在用户设置中显式指定："color_scheme": "Packages/User/MyCFMLTheme.sublime-color-scheme" - 在该文件的
rules数组里加针对 CFML scope 的规则，例如：{ "name": "CFML Keyword", "scope": "keyword.control.cfml", "foreground": "#E06C75" }
别漏掉 cfscript 内部的 JavaScript 部分——它走的是 JS 语法解析，颜色由 keyword.control.js 等 scope 控制，和 CFML 标签无关。
补全不工作或只补标签不补函数？这是插件能力边界
sublimetext-cfml 目前只提供基础补全：CFML 标签（<cfset>）、属性（query=）、cfscript 关键字（var, function）。它**不解析运行时环境**，因此不会补 query.recordcount、structKeyList() 这类函数或对象成员。
如果你需要 Lucee/ColdFusion 运行时级别的智能补全，得接受两个现实：
- Sublime 生态里没有成熟方案能动态加载 CFML 引擎的 API 元数据
- 插件自带的
cfml.sublime-completions是静态列表，新增函数需手动维护（见项目CFML/completions/目录） - 遇到
cfhttp属性不补全、cfquery的datasource参数没提示，属于正常现象，不是配置错误
真正容易被忽略的一点：插件默认关闭部分补全行为以避免干扰。检查 Preferences → Package Settings → CFML → Settings – User，确认没误加 "auto_complete": false 或 "enable_auto_completion": false 这类禁用项。
