vscode本身不支持cobol，所有功能依赖外部工具链：cobc路径错误、文件后缀非.cbl/.cob、未启用对应扩展或remote-ssh未连通z/os uss，均会导致编译失败、无法执行或语法不亮。
cobc 找不到、编译成功却无法执行、IDENTIFICATION DIVISION 不高亮——这些问题不是 VSCode 的锅，而是 COBOL 开发链路里某个环节断了。VSCode 本身不带 COBOL 编译器，也不连大型机，它只负责调用你本地或远程已有的工具。配不起来，90% 是 cobc 路径没对、.cbl 文件没被识别、或者根本没连上 z/OS USS。
确认 cobc 是否真可用，别信“安装过”
VSCode 不会帮你装编译器，所有运行能力都来自终端能跑通的 cobc。在 VSCode 内置终端（不是系统终端）里直接敲：cobc --version
必须返回类似 GnuCOBOL 3.2.0 的输出。如果报 command not found，说明：
• Windows 用户没运行 set_env.cmd，PATH 没生效
• macOS/Linux 用户用 Homebrew 安装后路径不对：/opt/homebrew/bin/cobc（M1/M2）或 /usr/local/bin/cobc（Intel）
• 路径含空格或中文（比如 C:\Program Files\GnuCOBOL\bin\cobc.exe），会导致 cobc -x 解析失败，报 invalid option -- 'x'
tasks.json 必须带 -x，否则编译完也跑不起来
VSCode 的任务系统是连接编辑器和命令行的唯一桥梁。没配 tasks.json，就只能切窗口手动敲命令。
关键点：
• "command" 必须写成 "${config:coboleditor.cobcPath}"，不能硬写 "cobc"（否则跨平台失效）
• "args" 至少包含 "-x"（生成可执行文件）、"-g"（调试必需）、"${file}"（当前文件）
• Windows 下建议显式指定输出名："${fileBasenameNoExtension}.exe"，避免默认的 a.out.exe 被杀软拦截
• Linux/macOS 若用 cobc -x 编译出二进制但运行时报 libcob.so not found，需补环境变量：export LD_LIBRARY_PATH=/usr/local/lib
文件后缀和扩展启用状态决定语法是否生效
VSCode 不会自动把任意文本当 COBOL 处理。两个硬性条件缺一不可：
• 文件后缀必须是 .cbl 或 .cob（不是 .txt 或 .log）
• 在 VSCode 设置中加 "files.associations": {"*.cbl": "cobol", "*.cob": "cobol"}，否则扩展不激活
• 扩展必须是 bitlang.cobol（基础语法）或 IBM Z Open Editor（企业级），其他名字相似的扩展大概率不支持代码片段（如输入 id + Tab 展开 IDENTIFICATION DIVISION）
• 如果 IDENTIFICATION DIVISION 不高亮，先检查右下角语言模式是否显示为 cobol，不是则点击切换
远程调试 z/OS 时，SSH 连的是 USS，不是 TSO
想在 VSCode 里调试银行系统里的 COBOL，cobc 就没用了，得走 Remote-SSH + z/OS USS。
常见卡点：
• HostName 填的是 LPAR 名或 TSO 主机地址，实际要填 USS 可达的 IP 或主机名
• User 填的是 TSO ID（如 TSO123），USS 要求真实 UID（如 ibmuser），否则静默失败
• 连接后 pwd 返回 / 或报错，说明用户没授权进 USS，需在 z/OS 上执行 chmod 755 /u/ibmuser
• tasks.json 里调 cob2 报 command not found，是因为 z/OS USS 中 cob2 不在默认 PATH，且必须前置环境变量：_CEE_RUNOPTS="FILEDATA=STD"
真正麻烦的从来不是配置步骤，而是每一步都依赖前一步的精确结果：终端里 cobc --version 不成功，后面所有 JSON 配置都是摆设；Remote-SSH 连不上 USS，IBM Z Open Editor 再多功能也白搭。路径、权限、用户上下文——这些看似底层的东西，才是 COBOL 在现代编辑器里跑起来的真实门槛。
