VSCode如何设置仅在首次打开文件夹时运行一次任务？

核心问题在于VSCode重载工作区时会再次触发folderOpen事件，而instanceLimit: 1只是限制同一任务的并发运行数，没法阻止重载后重新启动任务。可以通过工作区状态标记来避免重复执行，具体实现方式如下：

方法一：在任务命令中加入状态判断 #

利用VSCode的${workspaceState:key}变量存储任务是否已执行的标记，任务启动前先检查这个标记，未执行过才运行任务并更新标记。

Windows（PowerShell）配置示例 #

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "仅首次打开工作区运行",
      "type": "shell",
      "command": "if (-not ${workspaceState:hasRunTask}) { 
          # 替换成你的实际任务命令，比如：npm install
          npm install;
          # 标记任务已执行
          code --set-workspace-state hasRunTask true
        }",
      "runOptions": {
        "runOn": "folderOpen",
        "instanceLimit": 1
      }
    }
  ]
}

Linux/macOS（Bash）配置示例 #

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "仅首次打开工作区运行",
      "type": "shell",
      "command": "if [ -z \"${workspaceState:hasRunTask}\" ]; then 
          # 替换成你的实际任务命令，比如：npm install
          npm install;
          # 标记任务已执行
          code --set-workspace-state hasRunTask true;
        fi",
      "runOptions": {
        "runOn": "folderOpen",
        "instanceLimit": 1
      }
    }
  ]
}

方法二：重置状态（可选） #

如果需要下次打开工作区时重新执行任务，可以手动清除状态：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
• 输入Workspace State: Delete Key，然后输入hasRunTask即可重置标记

注意事项 #

• code --set-workspace-state命令需要VSCode的命令行工具已加入系统路径，若未配置，可替换为绝对路径（比如Windows下的C:\Program Files\Microsoft VS Code\bin\code.cmd）
• 这个标记是绑定到当前工作区的，切换其他工作区不会受影响

内容的提问来源于stack exchange，提问作者Juergen