VSCode任务系统无需tasks.json即可自动检测常见命令：package.json scripts、tsconfig.json、go.mod、pyproject.toml等触发对应任务；仅需手动配置tasks.json来控制执行细节，如工作目录、参数、变量引用等。
VSCode 的任务系统不是必须配 tasks.json 才能用——很多常见命令（比如 tsc、npm run build）开箱即用，只要对应工具在 $PATH 里。
哪些任务能自动检测出来？
VSCode 会扫描工作区根目录下的配置文件，主动提供“运行任务”建议：
-
package.json里的scripts字段（如"build": "tsc --build"）→ 自动列出npm: build - TypeScript 项目有
tsconfig.json→ 提供typescript: build和typescript: watch - Go 项目有
go.mod→ 推荐go: build、go: test - Python 项目有
pyproject.toml或setup.py→ 可能触发python: lint等（取决于已启用的扩展）
这些都不需要手动写 tasks.json。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Tasks: Run Task 就能看到列表。
什么时候必须手写 tasks.json？
当你需要控制执行细节时，比如：指定工作目录、传参、复用变量、链式执行、或调用非标准命令路径下的工具。
生成方式很简单：打开命令面板 → 输入 Tasks: Configure Task → 选 Create tasks.json file from template → 选一个模板（如 Others 最通用）。
最小可用配置长这样：
{
"version": "2.0.0",
"tasks": [
{
"label": "echo hello",
"type": "shell",
"command": "echo",
"args": ["hello from task"],
"group": "build",
"problemMatcher": []
}
]
}
关键点：
-
"type": "shell"表示走系统 shell（bash/zsh/cmd.exe），"process"则绕过 shell，更干净但不支持管道/重定向 -
"args"是字符串数组，不要拼成一整条命令字符串（错："echo hello world"；对：["echo", "hello", "world"]） -
"group": "build"让它出现在Terminal > Run Build Task快捷菜单里 -
"problemMatcher"留空或设为[]可避免误解析输出为错误（尤其跑脚本时）
tasks.json 里怎么引用当前文件、文件夹、选中文本？
VSCode 提供了一组预定义变量，只在任务运行时展开：
-
${file}→ 当前打开的文件绝对路径（含扩展名） -
${fileBasenameNoExtension}→ 文件名不含扩展（适合传给编译器） -
${relativeFile}→ 相对于工作区根目录的路径 -
${selectedText}→ 当前编辑器中选中的文本（慎用，没选中时为空） -
${workspaceFolder}→ 工作区根目录绝对路径
例如，为单个 Python 文件快速运行：
{
"label": "python: run current file",
"type": "shell",
"command": "python",
"args": ["${file}"],
"group": "build"
}
注意：${file} 在未保存的临时文件（Untitled-1）上会是空值，任务会失败。加个判断逻辑要靠外部脚本，VSCode 任务本身不支持条件分支。
为什么任务执行后终端立刻关闭？怎么看到完整输出？
默认行为是：任务结束后关闭集成终端。这不是 bug，是设计——避免一堆闲置终端卡着。
想保留终端并查看输出，加这行：
-
"isBackground": true→ 任务标记为后台任务（需配合problemMatcher检测开始/结束信号） -
"presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared", "showReuseMessage": true }→ 控制终端面板行为
最简单省事的办法：把 "group" 设为 "build"，然后用 Terminal > Run Build Task（Ctrl+Shift+B），它默认复用同一个终端面板，不会闪退。
真正容易被忽略的是：任务配置里的 cwd（工作目录）默认是 ${workspaceFolder}，但如果你在子文件夹里右键运行任务，而没显式设 "cwd": "${fileDirname}"，就可能因路径不对导致命令找不到依赖或配置文件。
