VS Code调试ColdFusion需通过Java调试器连接其JVM进程：1. 服务器端启用JDWP调试端口；2. 安装Debugger for Java扩展并配置launch.json（type为java、request为attach）；3. 正确设置sourcePaths指向本地源码目录；4. 排查日志、端口监听及源码映射问题。
VS Code 本身不原生支持 ColdFusion（CFML），但可通过插件 + 服务器调试协议实现完整开发体验：语法高亮、代码补全、断点调试都可行，关键在于绕过“ColdFusion不是独立语言”的认知误区——它跑在 JVM 上，本质是 Java 应用。
安装 CFML 语法支持与基础插件
CFML 在 VS Code 中属于“非主流语言”，没有官方扩展，但社区维护的 cfml 插件（作者：KamasamaK）覆盖了绝大多数需求：
- 安装后自动识别
.cfm、.cfc、.cfml文件，提供标签闭合、函数提示、CFScript 语法高亮 - 不依赖服务器，开箱即用；但注意它**不提供运行时校验**（比如变量未定义、函数拼错），只做静态解析
- 搭配
Path Intellisense可补全<cfinclude>或<cfmodule>的路径，避免手敲出错 - 若用 Lucee，可额外装
Lucee Server Extension（非必需），用于快速查看服务器状态、日志片段
配置 launch.json 实现 ColdFusion 断点调试
调试 ColdFusion 不是调用 cfdebug 命令，而是让 VS Code 的 Java 调试器连接 ColdFusion/Lucee 的 JVM 进程。这要求两端端口、路径、源码映射完全对齐：
- 服务器端必须启用 JDWP，例如在 Adobe CF 的
jvm.config中添加：-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000 - VS Code 中安装
Debugger for Java扩展（不是 “Java Extension Pack” 全家桶，仅此一个） -
launch.json的type必须设为java，request为attach，且hostName和port必须与服务器配置一致 -
sourcePaths是最易出错项：必须指向你本地编辑的 CFML 文件目录（如${workspaceFolder}），而非服务器部署路径；否则断点会显示“源码未找到”
常见调试失败原因与验证步骤
连不上、断点灰、变量看不到——90% 问题出在三个环节，按顺序排查比重装插件更有效：
- 检查 ColdFusion 日志（
cfserver.log或lucee-server/context/logs/）是否含Listening for transport dt_socket，没有说明 JDWP 未生效 - 用
netstat -ano | findstr :8000（Windows）或lsof -i :8000（macOS/Linux）确认端口确实在监听，且进程 PID 属于 ColdFusion - 在 VS Code 的
DEBUG CONSOLE中看连接日志：出现Connection refused是网络/防火墙问题；出现Source not found则一定是sourcePaths配置错误或文件编码不匹配（CFML 文件需保存为 UTF-8 无 BOM） - 别忽略浏览器缓存：CFML 页面被缓存后，即使服务端改了代码、打了断点，浏览器仍请求旧版本，导致“断点没触发”假象
真正卡住的地方往往不是配置本身，而是 ColdFusion 的“双态”特性：你写的 .cfm 文件在服务器上会被编译成 Java class 再执行，而 VS Code 调试的是这个中间态——所以源码路径映射必须严格对应编译前的原始结构，任何软链接、符号路径、IDE 自动生成的临时目录都会破坏调试链路。
