VSCode运行COBOL需先安装GnuCOBOL并配置cobcPath，再通过tasks.json定义含-x参数的编译任务，终端输出是定位错误的关键依据，源码格式（如第7列空格）必须严格符合COBOL规范。
VSCode 本身不能直接运行 COBOL，必须依赖外部编译器（如 GnuCOBOL）和显式配置才能完成“写 → 编译 → 执行”闭环。没有 cobc 就没有运行，光装扩展只是让代码看起来像 COBOL 而已。
确认本地已安装 GnuCOBOL 并可被调用
这是整个流程的硬性前提。VSCode 不自带 COBOL 编译器，所有执行能力都来自 cobc 命令。
- 终端中运行
cobc --version，必须返回类似GnuCOBOL 3.2.0的输出；若提示 command not found，说明未安装或 PATH 未生效 - Windows 用户注意：GnuCOBOL 安装后需手动运行
set_env.cmd，否则cobc不在环境变量中 - macOS/Linux 用户若用 Homebrew 安装，路径通常是
/opt/homebrew/bin/cobc（Apple Silicon）或/usr/local/bin/cobc（Intel）；路径错会导致后续所有任务静默失败
配置 coboleditor.cobcPath 指向真实可执行文件
仅靠扩展自动发现 cobc 并不可靠，尤其跨平台或自定义安装路径时，必须显式指定。
- 打开 VSCode 设置（
Cmd+Shift+P→Preferences: Open Settings (JSON)） - 添加字段：
"coboleditor.cobcPath": "/opt/homebrew/bin/cobc"（macOS）或"coboleditor.cobcPath": "C:\Program Files\GnuCOBOL\bin\cobc.exe"（Windows） - 该配置直接影响右键菜单中的 “Build with cobc” 是否可用，也影响 tasks.json 中 shell 调用能否定位到编译器
- 路径中不要包含空格或中文，否则
cobc -x极易因参数解析失败而报错invalid option -- 'x'
用 tasks.json 实现一键编译 + 运行
VSCode 的任务系统是连接编辑器与命令行工具的核心桥梁，不配 tasks.json，就只能切窗口手动敲命令。
- 在项目根目录建
.vscode/tasks.json，内容至少包含："type": "shell"、"command": "${config:coboleditor.cobcPath}"、"args": ["-x", "-g", "${file}"] -
-x是关键：生成可直接执行的二进制（而非仅 .o），否则无法运行；漏掉它会编译成功但无输出文件 -
-g不是运行必需，但调试前必须加，否则launch.json无法加载符号信息 - Windows 下需额外处理路径分隔符，建议在 args 中用
"${fileBasenameNoExtension}.exe"显式指定输出名，避免默认生成的a.out.exe被杀毒软件拦截
运行失败时优先检查终端输出而非问题面板
COBOL 编译错误（尤其是语法或数据部结构问题）通常不会被 VSCode 的问题面板自动解析，因为扩展对 cobc 错误格式的支持有限。
- 按下
Cmd+Shift+B触发任务后，紧盯集成终端输出，而不是只看右下角弹窗或问题面板 - 常见假阳性：终端显示
Compilation finished successfully，但实际生成的是.i预处理文件——说明漏了-x参数 - 常见真错误：
error: 'PROCEDURE DIVISION' expected, but found 'IDENTIFICATION DIVISION'，本质是段顺序错误，但 VSCode 不会高亮对应行，得靠终端定位 - 如果终端无输出，大概率是
tasks.json中command路径写错，或cobcPath配置未生效（重启 VSCode 窗口可验证）
最易被忽略的一点：COBOL 对源码格式极度敏感——第 7 列是否为空格、第 8–11 列是否为序号区、续行符是否在第 7 列……这些都不会触发语法高亮或任务报错，但会让 cobc 直接拒绝编译。写完先用终端跑一次 cobc -free your.cbl（加 -free 放宽格式限制），再逐步收紧校验。
