vscode保存即构建需配置tasks.json启用--watch模式任务并勾选“tasks: save before run”及“run on save”，配合problemmatcher捕获错误；若脚本不支持监听则仅执行一次。
VSCode里怎么让保存代码就自动构建
保存即构建不是开箱即用的功能，得靠 tasks.json + 文件监视器（watch）组合实现，且必须项目本身支持监听模式（比如 npm run build --watch 或 tsc --watch）。
- 在
.vscode/tasks.json中定义一个带--watch参数的 task，type设为shell，isBackground设为true，并配好problemMatcher捕获编译错误 - 启用“保存时运行任务”：打开设置，搜索
save before run，勾选Tasks: Save Before Run；再通过命令面板运行Tasks: Configure Task→ 选择你的构建任务 → 勾选Run on save - 注意：若构建脚本不支持热监听（如普通
npm run build），保存后只会跑一次就退出，不会持续响应后续修改 - 常见坑：
isBackground: true必须配合problemMatcher，否则 VSCode 无法判断任务是否真正启动成功，会卡在“正在运行”状态
如何让本地 task 和 GitHub Actions 行为一致
关键不是写两套逻辑，而是复用同一套命令——把构建、测试、lint 等操作封装成 npm script，然后在 tasks.json 和 .github/workflows/ci.yml 里都调用它。
-
tasks.json中的command直接写npm run build，不要展开成tsc && webpack；CI 脚本也保持run: npm run build - 确保
package.json的scripts字段覆盖所有流水线阶段：比如"test": "jest"、"lint": "eslint ."、"build": "tsc --build" - Node.js 版本差异会导致行为不一致：在
tasks.json的env字段里显式指定NODE_OPTIONS或用nvm use切换版本，CI 中也要用actions/setup-node锁定相同版本 - 路径问题常被忽略：
vsce package这类命令依赖当前工作目录是扩展根目录，tasks.json需设"options": { "cwd": "${workspaceFolder}/Extension" }，否则本地构建失败
为什么 act 本地运行 CI 时总卡在 actions/checkout@v4
这是网络和兼容性双重问题：act 默认不模拟 GitHub 的 secret 注入和 action marketplace 下载机制，actions/checkout@v4 依赖远程 fetch，本地根本拉不到。
- 临时解法：改用
actions/checkout@v3（v4 引入了 Git 2.40+ 依赖，而多数act镜像自带 Git 2.39） - 更稳妥的做法是跳过 checkout 步骤——在
act启动前手动git init && git add . && git commit -m "init"，然后加参数-s git=false禁用自动 clone - 如果 workflow 里用了
secrets.GITHUB_TOKEN，act无法提供等效凭证，得改用INPUT_TOKEN环境变量 + 自定义 action 替代 - 验证是否真因 action 导致失败：运行
act -j build -v查看 verbose 日志，重点找error: failed to download action或failed to resolve inputs
GitLab CI 流水线在 VSCode 里怎么获得正确提示和校验
默认 YAML 插件只认通用语法，对 .gitlab-ci.yml 特有字段（如 image、before_script、artifacts）没补全也没报错，得手动绑定 schema。
- 安装
YAML插件（Red Hat 出品），打开设置 →yaml.schemas→ 添加映射："https://json.schemastore.org/gitlab-ci.json": ".gitlab-ci.yml" - 别用通配符匹配，比如写成
"*.yml"，否则会把docker-compose.yml也套上 GitLab schema，导致误报 - GitLab 官方 schema 不包含自定义关键字（如你写的
extends或私有模板），若提示 “unknown key”，属于正常现象，可忽略或在 schema 中手动扩展 - 缩进仍是最大雷区：
script下多行命令必须用|开头，且后续每行缩进比|多至少 2 格，少 1 格就触发Expected a mapping
tasks.json 里容易被当成“理所当然”，却恰恰是 CI 失败时最难定位的环节。
