vscode不运行ci/cd流水线，仅支持编写调试；需安装github actions或gitlab ci专用插件实现语法高亮与校验；缩进错误、冒号后缺空格等导致yaml解析失败；可用act工具本地模拟执行并配合tasks.json一键触发。
VSCode 本身不运行 CI/CD 流水线，它只是编辑器；真正执行流水线的是 Git 服务器（如 GitHub Actions、GitLab CI）或独立 runner。你在 VSCode 里能做的，是高效编写、调试和验证流水线定义文件——关键在于配置好语法支持、校验和一键触发能力。
如何让 .yml 文件获得正确的 CI 配置语法高亮与补全
GitHub Actions 和 GitLab CI 都用 YAML 描述流水线，但语义不同。默认的 YAML 插件无法识别 jobs、on、uses 等特有关键字，导致无提示、易拼错。
- 安装官方插件：
GitHub Actions（作者：GitHub）——专为.github/workflows/*.yml提供 schema 校验、关键字补全、图标标记 - 对 GitLab CI，安装
GitLab CI Linter或启用YAML插件的自定义 schema：在settings.json中添加："yaml.schemas": { "https://json.schemastore.org/gitlab-ci.json": "/.gitlab-ci.yml" } - 避免用通用
YAML插件单独处理 —— 它会把run: npm test当作普通字符串，不校验run是否在合法上下文中
为什么 vscode-yaml 插件开启 validation 后仍报错 Expected a mapping
这是 YAML 缩进错误的典型提示，但 VSCode 往往不标出具体哪一行缩进异常，尤其在嵌套 if、matrix 或多行脚本中。
- 检查所有冒号
:后是否**紧跟一个空格**，例如runs-on:ubuntu-latest（缺空格）会直接解析失败 -
steps下每个- name:必须顶格或严格对齐到上一级steps的缩进位置，不能多 1 或少 1 个空格 - 多行脚本用
|或>时，后续行必须比|所在行**多缩进 2 格以上**，否则 YAML 解析器认为内容不属于该字段 - 临时验证方法：右键打开命令面板 → 运行
YAML: Validate Schema，看输出面板里是否列出具体行号
如何在 VSCode 里一键触发本地 CI 流水线测试（绕过远端）
你不需要推送到 GitHub 才知道 workflow 是否写对。借助 act 工具，可在本地模拟 GitHub Actions 运行环境。
- 先安装
act：brew install act（macOS）或sudo apt install act（Ubuntu），Windows 用户用 Scoop - 在项目根目录运行：
act -j build（build是.yml中 job 的名字），它会拉取对应 runner 镜像并执行 - 配合 VSCode 任务：在
.vscode/tasks.json中定义一个 task，command 设为act，就能用Ctrl+Shift+P → Tasks: Run Task快速触发 - 注意：本地
act不支持所有官方 action（如actions/checkout@v4需要网络），遇到失败先查act的 compatibility 表
真正卡住人的往往不是语法，而是环境变量作用域、job 间 artifact 传递路径、以及 matrix 构建时 shell 变量展开时机——这些在 VSCode 里看不到运行时状态，必须靠 act 或最小化复现来定位。
