VSCode本身不支持定时任务，仅能通过tasks.json手动触发、文件夹打开时运行或保存时靠扩展触发；真定时需依赖系统级工具（如cron或Task Scheduler）调用VSCode任务，或在脚本内嵌schedule库实现。
VSCode 里根本不能直接配“定时任务”
VSCode 本身没有内置的 cron 或定时调度能力，tasks.json 只支持手动触发、打开文件夹时运行（"runOn": "folderOpen"）或保存时靠扩展间接触发。所谓“定时任务”，实际是靠外部工具 + VSCode 任务组合实现的。
常见错误现象：tasks.json 里写 "schedule": "0 * * * *" 报错、任务从不自动执行、以为装个插件就能像 Linux cron 一样跑——这些都源于混淆了 VSCode 任务系统和操作系统级调度器的边界。
- 真要定时执行脚本（比如每小时拉一次数据），必须用系统 cron（macOS/Linux）或 Task Scheduler（Windows），再让 VSCode 任务作为被调用的“入口命令”
- 开发阶段想模拟定时行为，推荐用
node-schedule或node-cron写在 JS 脚本里，然后用 VSCode 的launch.json直接调试该脚本 - 别在
tasks.json中硬塞定时逻辑——它不是运行时环境，只是命令封装器
用 launch.json 调试带定时逻辑的 Node.js 脚本
如果你的定时逻辑写在 src/cron-job.js 里（例如用 node-cron 每 5 分钟执行一次），就该用调试器启动，而不是任务系统。
关键点在于：VSCode 调试器能挂起进程、看日志、设断点；而 tasks.json 只负责执行完就退出，无法持续监听。
-
launch.json中"program"必须指向真实 JS 文件路径，推荐用变量："${workspaceFolder}/src/cron-job.js" - ESM 项目记得在
package.json加"type": "module"，否则import会报错 - 若脚本依赖
.env，不能指望自动加载——要在launch.json的envFile字段显式指定："envFile": "${workspaceFolder}/.env" - 避免用
nodemon包裹定时脚本：它会反复重启，破坏定时器状态；真要热更新，改用ts-node-dev并配--respawn
tasks.json 配合系统级定时器做部署前检查
真正实用的“定时任务”场景，其实是定期验证构建产物或清理缓存——这类操作适合交给系统调度器调用 VSCode 任务，而非让 VSCode 自己定时。
例如：每天凌晨 2 点检查 dist/ 是否存在且非空，失败则发告警。这时 tasks.json 只需定义一个可复用的校验任务，供外部调用。
- 任务 label 命名为
check build output，command 写成 shell 命令：test -d dist && test -n "$(ls -A dist)" - 别用
npm run check——跨机器可能没装 npm；优先用npx --no-install shx test -d dist（shx是跨平台 shell 工具） - 加
"problemMatcher": ["$shell"]，让失败时错误直接标在编辑器里，方便排查 - macOS 上用
crontab -e添加：0 2 * * * cd /path/to/project && code --reuse-window --wait --no-sandbox --new-instance . >/dev/null 2>&1 && /bin/zsh -c 'code --task "check build output"'（注意：VSCode CLI 的--task需已安装 Code CLI）
为什么“保存即定时”是个伪需求
有人想“每次保存 config.json 就自动触发一次同步任务”，这听起来像定时，实则是事件驱动。VSCode 任务系统不监听文件变更，runOptions.runOn: "save" 并不存在。
容易踩的坑：装了 Auto Run Command 扩展后，在设置里填 "**/*.json" 触发 npm run sync，结果发现只在首次保存生效、后续静默失败——因为扩展默认不重载任务定义，且未处理并发冲突。
- 真正可靠的做法是用
chokidar-cli：在终端运行npx chokidar "**/*.json" --on-change "npm run sync"，再把这条命令做成一个可随时启停的 VSCode 任务 - 若坚持用扩展，选 Trigger Task on Save，并确保 task 的
"isBackground": true，否则保存瞬间会卡住编辑器 - 别在
tasks.json里写循环 sleep 或 setInterval ——它不是运行环境，进程退出后一切清零
最常被忽略的点：所谓“定时”，本质是调度权归属问题。VSCode 只管怎么跑命令，不管什么时候跑；时间控制永远在系统层或脚本内。把责任边界划清楚，比堆配置重要得多。
