VS Code任务无法直接触发飞书通知，需用Python脚本封装编译与通知逻辑：检查退出码，捕获stdout/stderr，通过环境变量获取Webhook并用requests.post发送JSON消息，tasks.json中配置为非后台任务且传参调用该脚本。
VS Code 任务系统怎么触发飞书通知？
直接靠 tasks.json 本身做不到——它不支持 HTTP 请求或外部脚本的异步等待。必须把“编译/运行”和“发消息”拆成两个阶段：先用 shell 或 Python 脚本封装整个流程，再让 VS Code 任务调用这个脚本。
核心逻辑是：执行 gcc 或 python 后检查退出码，成功则发「✅ 编译通过」，失败则带错误日志发「❌ 编译失败」。不能依赖 VS Code 的 problemMatcher，它只解析输出，不控制后续动作。
- 脚本需接收当前工作目录、源文件名等参数（避免硬编码路径）
- 必须捕获标准错误流（
stderr），否则 GCC 报错信息会丢失 - 飞书 Webhook 地址严禁写死在脚本里，统一用环境变量
FEISHU_WEBHOOK管理
Python 脚本怎么安全调用飞书 Webhook？
用 requests.post() 最简单，但要注意三点：Content-Type 必须是 application/json；消息体必须是 JSON 格式；HTTP 超时必须设为 5 秒以内，否则 VS Code 任务会卡住。
示例关键片段：
import os, sys, subprocess, requests
webhook = os.getenv("FEISHU_WEBHOOK")
if not webhook:
print("⚠️ FEISHU_WEBHOOK not set"); sys.exit(1)
result = subprocess.run([sys.argv[1]], capture_output=True, text=True)
payload = {
"msg_type": "text",
"content": {"text": f"{'✅' if result.returncode == 0 else '❌'} {sys.argv[1]} → {result.returncode}\n{result.stdout[:200]}{result.stderr[:200]}"}
}
requests.post(webhook, json=payload, timeout=3)
-
subprocess.run(..., capture_output=True)是必须的，否则无法获取错误输出 -
result.stderr[:200]防止超长错误刷爆飞书卡片（飞书单条文本上限约 500 字符） - 不要用
os.system()，它无法捕获返回值和输出
tasks.json 怎么配置才能传参并等脚本结束？
重点在 "isBackground": false 和 "group": "build"。前者确保 VS Code 等待脚本退出，后者让任务归类到「构建」组，方便快捷键 Ctrl+Shift+B 触发。
典型配置（假设脚本叫 notify_on_build.py）：
{
"version": "2.0.0",
"tasks": [{
"label": "build & notify",
"type": "shell",
"command": "python notify_on_build.py \"gcc -o hello hello.c\"",
"args": [],
"group": "build",
"isBackground": false,
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}]
}
-
"command"里用双引号包裹整个命令，避免空格被截断 - 不要加
&或nohup，否则 VS Code 会认为任务已结束，飞书消息可能发不出去 -
"panel": "shared"让所有构建任务共用一个终端，避免弹窗泛滥
Webhook 地址泄露和消息格式有哪些坑？
Webhook 地址一旦泄露，任何人可伪造消息。最易犯的错是把地址直接写进 tasks.json 或 Git 提交的脚本里。正确做法只有两种：设为系统环境变量，或用 .env 文件配合 python-dotenv 加载（但 VS Code 默认不读 .env，所以环境变量更可靠）。
飞书对消息体校验极严：
- 字段名必须小写，
msg_type写成Msg_Type会静默失败 -
text字段必须是字符串，不能是 dict 或 list - 如果想发富文本，改用
"msg_type": "post"，但需额外构造content结构，复杂度陡增
真正容易被忽略的是：VS Code 任务默认使用集成终端的 shell（如 PowerShell on Windows），而 Python 脚本在不同 shell 下对引号、路径分隔符的处理差异极大。建议统一在脚本开头加 #!/usr/bin/env python3 并用 chmod +x，然后在 tasks.json 中直接调用脚本名，绕过 shell 解析歧义。
