vscode本身不运行cobol，必须依赖外部编译器cobc；确认cobc已安装且path生效是硬性前提，需通过终端执行cobc --version验证，再显式配置coboleditor.cobcpath和tasks.json中含-x参数的编译任务，源码第7列空格等格式须严格符合规范。
VSCode 本身不运行 COBOL，它只负责编辑和调度；真正执行靠的是外部编译器（如 cobc）生成可执行文件，再由系统调用。没装 cobc，所有“右键构建”“一键运行”都只是假动作。
确认 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），别用模糊的which cobc结果——它可能指向旧版本或 alias - 路径含空格或中文？
cobc -x会因参数解析失败报invalid option -- 'x'，必须重装到纯英文无空格路径
coboleditor.cobcPath 必须显式配置
VSCode 的 COBOL 扩展不会自动猜对 cobc 位置，尤其跨平台或自定义安装时，靠“自动发现”基本等于放弃。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Preferences: Open Settings (JSON)，打开settings.json - 添加字段：
"coboleditor.cobcPath": "/opt/homebrew/bin/cobc"（macOS）或"coboleditor.cobcPath": "C:\Program Files\GnuCOBOL\bin\cobc.exe"（Windows） - 注意 Windows 路径用双反斜杠
\或正斜杠/，别用单反斜杠——JSON 会解析失败 - 这个配置决定右键菜单中 “Build with cobc” 是否亮起，也影响
tasks.json调用能否定位到编译器
tasks.json 里 -x 参数不能漏
没有 -x，cobc 默认只生成目标文件（.o），不会产出可执行文件，后续根本没法运行。
- 项目根目录建
.vscode/tasks.json，内容至少包含："type": "shell"、"command": "${config:coboleditor.cobcPath}"、"args": ["-x", "-g", "${file}"] -
-g是调试必需，但不是运行必需；不过漏掉它，后续用launch.json调试时会找不到符号信息 - Windows 下建议显式指定输出名：
"args": ["-x", "-g", "${file}", "-o", "${fileBasenameNoExtension}.exe"]，避免默认生成a.out.exe被杀软拦截 - 编译成功但没输出文件？第一反应就是检查
-x是否拼错、是否被误删、是否被包裹在引号里（如"-x"在某些 shell 下反而失效）
运行失败先盯终端，别信问题面板
COBOL 编译错误（比如 MISSING PERIOD、INVALID DATA NAME、第7列没空格）几乎不会被 VSCode 问题面板自动提取，因为扩展对 cobc 错误格式的支持很弱。
- 按下
Ctrl+Shift+B（或右键 → Build with cobc）后，立刻切到 VSCode 终端（Terminal标签页），看原始输出 - 典型错误如：
Error: syntax error, unexpected END OF INPUT, expecting IDENTIFICATION DIVISION—— 往往是第7列少了个空格，或IDENTIFICATION DIVISION.后没换行 - 如果终端没输出、任务静默结束，大概率是
cobcPath配错，或tasks.json中command路径写成相对路径、带空格没转义 - 源码必须严格符合 COBOL 格式：第1–6列留空（或写序号），第7列必须是空格，第8–72列写代码——编辑器不报错，但
cobc会拒编
复杂点在于 COBOL 对格式的刻板要求和 VSCode 对它的“半吊子”支持之间存在断层：你得同时懂古董规则（列位置、部首顺序）和现代工具链（路径、JSON 配置、shell 参数）。最容易被忽略的，是以为装了扩展就万事大吉，结果连 cobc --version 都跑不通。
