VS Code 怎样把代码操作录制成可复用任务

VS Code 的 Tasks 不能直接把鼠标点击、光标移动或键盘编辑操作“录制”为宏。若要复用的是构建、语法检查、代码生成等已有命令，可以把命令写进项目的 .vscode/tasks.json，之后从 Terminal → Run Task… 再次运行。这里保存的是命令配置，不是编辑动作录像。

下面以“检查一个 JavaScript 文件的语法”为例：把 Node.js 的检查命令保存成项目任务，解决每次重复输入命令、运行目录不一致和任务找不到的问题。示例供读者自行操作，本文未实际执行软件或命令；配图全部为原创界面说明。

官方地址：https://code.visualstudio.com/

步骤一：从任务配置入口建立项目任务

先通过 File → Open Folder… 打开独立演示文件夹。在资源管理器中新建 scripts 目录和 scripts/demo.js，写入下面内容并保存。示例依赖当前任务运行环境能够找到 Node.js；VS Code 编辑器本身不等于已安装命令行 node。

// 原创语法检查样例；--check 只检查语法，不会执行输出
const report = { name: "sample", enabled: true };
console.log(report.name);

打开顶部菜单 Terminal → Configure Tasks…，或通过命令面板搜索 Tasks: Configure Task。首次创建时选择 Create tasks.json file from template → Others。不同版本的菜单译名可能不同，英文命令名可作为查找依据。

应看到编辑器打开项目里的 .vscode/tasks.json。如果文件原本已经存在，通常会打开现有配置；此时只在已有 tasks 数组追加本例任务，不要覆盖原项目任务。若没有打开文件夹，先返回 Open Folder，而不是把“任务入口消失”当成需要录制插件的问题。

步骤二：把实际命令保存到 tasks.json

在全新演示项目中，把模板换成以下 JSONC。已有项目则合并数组项，顶层 version 保留正确值。这份配置使用 process 类型，直接运行 node，把文件路径作为参数传递。

{
  "version": "2.0.0",
  "tasks": [
    {
      // 任务列表中的名称，可重复选择运行
      "label": "检查演示脚本",
      "type": "process",
      "command": "node",
      // 参数分别传递，不依赖 Shell 的引号和重定向规则
      "args": ["--check", "scripts/demo.js"],
      "options": {
        "cwd": "${workspaceFolder}"
      },
      // 本例只看进程退出结果，不把文本映射为编辑器问题
      "problemMatcher": []
    }
  ]
}

按 Ctrl+S（macOS 为 Cmd+S）保存。预期可见状态是 tasks.json 标签的未保存标记消失；任务 label 为“检查演示脚本”，command 为 node，args 中有两个独立参数。JSONC 支持这里的中文注释，不需要为了保留注释改成脚本文件。

这里的 ${workspaceFolder} 是 VS Code 任务变量，不是让读者手工替换的私人绝对路径。由于 args 分项传递，即使项目所在目录含空格，也不必自己把整条命令拼成多层引号。若任务确实需要管道或重定向，再选择 shell 类型并按平台处理其语法。

--check 的具体行为由 Node.js 决定，本例只做语法检查，不运行 console.log，也不承诺完成类型检查、测试或代码质量分析。因此没有看到 sample 输出，不能据此判为任务失败。

步骤三：从任务列表重复运行并定位失败

打开 Terminal → Run Task…，选择 检查演示脚本。也可以在命令面板运行 Tasks: Run Task 后选同一标签。保存正确后，列表中应能够找到这个任务；以后仍通过相同入口重复选择。

任务实际输出由 VS Code 集成终端承载。Node.js 对合法文件的语法检查成功时通常不会输出业务内容，应结合进程是否正常结束及退出码判断；若出现语法错误，则按报告的文件与位置修改并保存 demo.js，再重新运行同一个任务。本文没有展示或生成终端截图。

如果提示找不到 node，检查任务实际运行位置的依赖：本机项目使用本机环境，远程 SSH、容器等环境则需要相应位置的 Node.js。修改系统 PATH 后可能需要重新启动 VS Code，让它继承新环境；不要因为本机另一个窗口能运行 node，就假设远程任务也一定可用。

若提示找不到脚本，先看 scripts/demo.js 是否保存于当前打开的根目录，再检查 cwd。相对路径由任务工作目录决定，不由当前光标所在文件决定。对于多根工作区，要明确任务属于哪个文件夹，必要时使用具名工作区变量。

如果只在 Problems 面板看不到错误，本例的 problemMatcher 为空正是原因：没有错误条目不等于命令执行成功。任务输出解析与进程退出状态是不同信息，应先看实际命令结果，再按工具输出格式另行添加匹配器。

能把格式化、搜索替换和光标操作都录进去吗？

Tasks 不提供通用编辑动作录制器。能通过脚本或命令行表达的操作可转成任务；仅有编辑器交互的动作需要另行评估对应命令或扩展，不应把任务模板描述成已录制这些动作。

关闭 VS Code 后配置会丢吗？

保存的项目 tasks.json 仍在项目目录里。要让同事复用，可以按团队规则共享配置和脚本，同时说明所需工具版本与环境；不要把个人口令或本机私有路径写入共享任务。

取消任务会恢复命令修改过的文件吗？

不会自动回退文件修改。本例 --check 不执行脚本；换成生成或格式化命令后，取消进程也不等于撤销已写入的内容。停用本例时，从 tasks 数组删除对应任务项并保存，保留其他任务；演示脚本可按需自行移除。

任务类型、配置入口和工作区变量依据 VS Code Tasks 官方说明。Node.js 语法检查参数见 Node.js CLI 文档。示例内容和界面说明图为原创。