自定义终端不加载项目环境变量是因为插件进程非shell派生，不读取.zshrc等配置；需显式传入env对象或用绝对路径调用命令。
为什么自定义终端在插件调试中不加载项目环境变量
VSCode 插件开发时，插件进程启动的终端（比如通过 vscode.terminal.createTerminal() 创建）默认不继承工作区的 shell 环境配置，也不读 .zshrc、.bash_profile 或 nvm、volta 的版本切换逻辑。你看到 node --version 是系统全局版，npm run dev 报 command not found，基本都卡在这儿。
实操建议：
- 插件里创建终端时，显式传入
env对象，把关键变量带进去：vscode.terminal.createTerminal({ name: 'my-task', env: { ...process.env, NODE_ENV: 'development' } }) - 避免依赖
~/.zshrc中的export—— 插件进程不是从 shell fork 出来的，shellIntegration也无效 - 若需调用本地
node_modules/.bin下的命令（如ts-node），直接写绝对路径："./node_modules/.bin/ts-node"，别指望PATH自动补全
插件中触发 Task 任务失败：preLaunchTask 不生效的底层原因
你在插件代码里调用 vscode.debug.startDebugging() 并传了 preLaunchTask 字段，但任务根本没跑——这不是插件 API 写错了，而是 VSCode 的 task 系统压根没扫描到你的 tasks.json。
关键限制：
-
tasks.json必须位于被调试工作区的根目录.vscode/tasks.json，插件自己包里的tasks.json完全无效 -
preLaunchTask的值必须和tasks.json里某个task.label**完全一致**（大小写、空格、连字符都不能差） - 插件调用
startDebugging()时，当前活动的工作区（vscode.workspace.workspaceFolders[0]）必须存在且已加载，否则任务查找直接跳过，无报错 - 如果任务是
type: "shell"且含&&链式命令，Windows 下 PowerShell 默认策略会拦截脚本，得在tasks.json中加"options": {"shell": {"executable": "pwsh", "args": ["-Command"]}}
如何让插件自动监听并响应自定义 Task 的输出
你想在插件里捕获 tsc --watch 的错误行、或 webpack serve 启动成功的提示，但 Terminal.onDidWriteData 只吐原始字符串，没结构化解析能力。
更可靠的做法是绕过终端，直接复用 VSCode 的 problemMatcher 机制：
- 在插件中调用
vscode.tasks.executeTask()而非手动起终端进程 - 确保对应 task 配了
"problemMatcher": "$tsc-watch"（TypeScript）或"$gcc"（C/C++），VSCode 会自动把匹配到的错误注入Problems视图 - 监听
vscode.languages.onDidChangeDiagnostics，过滤出你关心的资源 URI 和诊断信息，比解析终端文本稳定得多 - 不要试图用正则从
onDidWriteData里抠ERROR in ./src/index.ts—— 编码、换行、ANSI 控制符会让它在不同终端下行为不一致
插件调试时 Terminal 实例无法复用的隐藏约束
你每次调用 createTerminal() 都新建一个 tab，但想复用已有终端（比如固定叫 build-output），却发现 vscode.window.terminals.find(t => t.name === 'build-output') 总是返回 undefined。
这是因为：
- 插件进程中的
vscode.window.terminals只返回当前 UI 窗口可见的终端实例，后台被用户手动关闭的终端不会缓存 - 插件调试时运行在独立的 Extension Development Host 窗口中，它看到的终端列表和主 VSCode 窗口完全隔离
- 没有 API 能“恢复”一个已关闭的终端；唯一可预测的方式是：始终用相同
name创建，并在创建前检查find结果，但要接受它可能为空 - 若需持久化输出，改用
vscode.window.createOutputChannel('MyPlugin')，它跨窗口、不关闭、支持追加日志，且能被用户聚焦查看
最易被忽略的一点：插件里所有终端操作都受限于当前激活的工作区上下文，切项目窗口后，之前创建的终端引用就失效了，别存 long-lived terminal 对象。
