应安装 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></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></cfquery>、cfloop、var 这些词标记为对应 scope(比如 keyword.control.cfml、support.function.cfml),真正决定颜色的是你当前启用的配色方案(color_scheme)。
验证和修复流程:
- 光标放在一个
<cfif></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></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 这类禁用项。











