简中文档
On this page

deno task

Command line usage

deno task [OPTIONS] [TASK]

Run a task defined in the configuration file.

deno task build

List all available tasks:

deno task

Evaluate a task from string

deno task --eval "echo $(pwd)"

Options Jump to heading

--config Jump to heading

Short flag: -c

Configure different aspects of deno including TypeScript, linting, and code formatting Typically the configuration file will be called deno.json or deno.jsonc and automatically detected; in that case this flag is not necessary.

--cwd Jump to heading

Specify the directory to run the task in.

--eval Jump to heading

Evaluate the passed value as if it was a task in a configuration file.

--filter Jump to heading

Short flag: -f

Filter members of the workspace by name, implies --recursive flag.

--recursive Jump to heading

Short flag: -r

Run the task in all projects in the workspace.

Dependency management options Jump to heading

--frozen Jump to heading

Error out if lockfile is out of date.

--node-modules-dir Jump to heading

Sets the node modules management mode for npm packages.

描述 Jump to heading

deno task 提供了一种跨平台的方式来定义和执行特定于代码库的自定义命令。

要开始使用，请在代码库的 Deno 配置文件 中定义您的命令，位于一个 "tasks" 键下。

例如：

{
  "tasks": {
    "data": "deno task collect && deno task analyze",
    "collect": "deno run --allow-read=. --allow-write=. scripts/collect.js",
    "analyze": {
      "description": "运行分析脚本",
      "command": "deno run --allow-read=. scripts/analyze.js"
    }
  }
}

指定当前工作目录 Jump to heading

默认情况下，deno task 使用 Deno 配置文件（例如 deno.json）的目录作为当前工作目录来执行命令。这允许任务使用相对路径，并继续工作，无论您从目录树的何处执行 deno task。在某些情况下，这可能不是所期望的，这种行为可以使用 INIT_CWD 环境变量覆盖。

如果没有设置，INIT_CWD 将被设为任务运行所在目录的完整路径。这与 npm run 的行为一致。

例如，以下任务将更改任务的当前工作目录，使之位于用户运行任务的相同目录，然后输出当前工作目录，现在就是该目录（请记住，这在 Windows 上也有效，因为 deno task 是跨平台的）。

{
  "tasks": {
    "my_task": "cd $INIT_CWD && pwd"
  }
}

获取 deno task 运行的目录 Jump to heading

由于任务使用 Deno 配置文件的目录作为当前工作目录，因此了解 deno task 是从哪个目录执行的可能会很有用。这可以通过在任务中或从 deno task 启动的脚本中使用 INIT_CWD 环境变量来实现（此方式与 npm run 的方式相同，但以跨平台方式实现）。

例如，要将该目录提供给任务中的脚本，请执行以下操作（注意，目录用双引号括起来，以便在包含空格的情况下将其作为单个参数保持）：

{
  "tasks": {
    "start": "deno run main.ts \"$INIT_CWD\""
  }
}

通配符匹配任务 Jump to heading

deno task 命令可以通过传递通配符模式并行运行多个任务。通配符模式用 * 字符指定。

deno.json
{
  "tasks": {
    "build-client": "deno run -RW client/build.ts",
    "build-server": "deno run -RW server/build.ts"
  }
}

运行 deno task "build-*" 将同时运行 build-client 和 build-server 任务。

Note

使用通配符时 确保引用任务名称（例如 "build-*"），否则您的 shell 可能会尝试扩展通配符字符，从而导致意外错误。

任务依赖 Jump to heading

您可以为任务指定依赖项：

deno.json
{
  "tasks": {
    "build": "deno run -RW build.ts",
    "generate": "deno run -RW generate.ts",
    "serve": {
      "command": "deno run -RN server.ts",
      "dependencies": ["build", "generate"]
    }
  }
}

在上面的示例中，运行 deno task serve 将首先并行执行 build 和 generate 任务，一旦它们都成功完成，serve 任务将被执行：

$ deno task serve
Task build deno run -RW build.ts
Task generate deno run -RW generate.ts
Generating data...
Starting the build...
Build finished
Data generated
Task serve deno run -RN server.ts
Listening on http://localhost:8000/

依赖任务是并行执行的，默认的并行限制等于您机器上的核心数量。要更改此限制，请使用 DENO_JOBS 环境变量。

依赖项会被跟踪，如果多个任务依赖同一任务，该任务只会运行一次：

deno.json
{
  //   a
  //  / \
  // b   c
  //  \ /
  //   d
  "tasks": {
    "a": {
      "command": "deno run a.js",
      "dependencies": ["b", "c"]
    },
    "b": {
      "command": "deno run b.js",
      "dependencies": ["d"]
    },
    "c": {
      "command": "deno run c.js",
      "dependencies": ["d"]
    },
    "d": "deno run d.js"
  }
}

$ deno task a
Task d deno run d.js
Running d
Task c deno run c.js
Running c
Task b deno run b.js
Running b
Task a deno run a.js
Running a

如果发现依赖之间存在循环，将返回错误：

deno.json
{
  "tasks": {
    "a": {
      "command": "deno run a.js",
      "dependencies": ["b"]
    },
    "b": {
      "command": "deno run b.js",
      "dependencies": ["a"]
    }
  }
}

$ deno task a
Task cycle detected: a -> b -> a

您还可以指定没有 command 的依赖任务。这对于逻辑上将几个任务分组在一起很有用：

deno.json
{
  "tasks": {
    "dev-client": "deno run --watch client/mod.ts",
    "dev-server": "deno run --watch sever/mod.ts",
    "dev": {
      "dependencies": ["dev-client", "dev-server"]
    }
  }
}

运行 deno task dev 将并行运行 dev-client 和 dev-server。

Node 和 npx 二进制支持 Jump to heading

默认情况下，deno task 将使用 deno 二进制执行命令。如果您需要确保命令使用 npm 或 npx 二进制运行，您可以通过分别调用 npm 或 npx 的 run 命令来实现。例如：

{
  "tasks": {
    "test:node": "npm run test"
  }
}

工作空间支持 Jump to heading

deno task 可用于工作空间，从多个成员目录并行运行任务。要执行所有工作空间成员的 dev 任务，请使用 --recursive 标志：

deno.json
{
  "workspace": [
    "client",
    "server"
  ]
}
client/deno.json
{
  "name": "@scope/client",
  "tasks": {
    "dev": "deno run -RN build.ts"
  }
}
server/deno.json
{
  "name": "@scope/server",
  "tasks": {
    "dev": "deno run -RN server.ts"
  }
}

$ deno task --recursive dev
Task dev deno run -RN build.ts
Task dev deno run -RN server.ts
Bundling project...
Listening on http://localhost:8000/
Project bundled

要运行的任务可以根据工作空间成员进行过滤：

$ deno task --filter "client" dev
Task dev deno run -RN build.ts
Bundling project...
Project bundled

请注意，过滤器是根据每个成员的 deno.json 文件中的 name 字段指定的工作空间成员名称进行匹配的。

语法 Jump to heading

deno task 使用一个跨平台的 shell，这是一个 sh/bash 的子集，用于执行定义的任务。

布尔列表 Jump to heading

布尔列表提供了一种根据初始命令的退出代码执行额外命令的方法。它们使用 && 和 || 运算符分隔命令。

&& 运算符提供了一种执行命令的方法，如果它 成功（退出码为 0），则执行下一个命令：

deno run --allow-read=. --allow-write=. collect.ts && deno run --allow-read=. analyze.ts

|| 运算符正好相反。它提供了一种执行命令的方法，仅在 失败（退出码非零）时执行下一个命令：

deno run --allow-read=. --allow-write=. collect.ts || deno run play_sad_music.ts

顺序列表 Jump to heading

顺序列表类似于布尔列表，但无论列表中前一个命令是否通过，都将执行。命令用分号 (;) 分隔。

deno run output_data.ts ; deno run --allow-net server.ts

异步命令 Jump to heading

异步命令提供了一种使命令异步执行的方法。这在启动多个进程时可能很有用。要使命令异步，请在命令末尾添加 &。例如，以下命令将在同一时间执行 sleep 1 && deno run --allow-net server.ts 和 deno run --allow-net client.ts：

sleep 1 && deno run --allow-net server.ts & deno run --allow-net client.ts

与大多数 shell 不同，第一个失败的异步命令将导致所有其他命令立即失败。在上面的例子中，这意味着如果服务器命令失败，则客户端命令也会失败并退出。您可以通过在命令末尾添加 || true 来选择退出此行为，这将强制返回 0 的退出代码。例如：

deno run --allow-net server.ts || true & deno run --allow-net client.ts || true

环境变量 Jump to heading

环境变量的定义方式如下：

export VAR_NAME=value

以下是如何在任务中使用一个环境变量的示例，使用 shell 变量替换，然后将其作为启动 Deno 进程的环境的一部分导出（注意，在 JSON 配置文件中，双引号需要用反斜杠转义）：

export VAR=hello && echo $VAR && deno eval "console.log('Deno: ' + Deno.env.get('VAR'))"

将输出：

hello
Deno: hello

为命令设置环境变量 Jump to heading

要在命令之前指定环境变量，请像下面这样列出：

VAR=hello VAR2=bye deno run main.ts

这将仅为以下命令使用这些环境变量。

Shell 变量 Jump to heading

Shell 变量与环境变量类似，但不会导出到已生成的命令中。它们使用以下语法定义：

VAR_NAME=value

如果我们在之前的 "环境变量" 部分的类似示例中使用 shell 变量而不是环境变量：

VAR=hello && echo $VAR && deno eval "console.log('Deno: ' + Deno.env.get('VAR'))"

我们将得到以下输出：

hello
Deno: undefined

Shell 变量在我们想重用某个值但又不希望在任何生成的进程中可用时非常有用。

退出状态变量 Jump to heading

以前运行命令的退出码在 $? 变量中可用。

# 输出 10
deno eval 'Deno.exit(10)' || echo $?

管道 Jump to heading

管道提供了一种将一个命令的输出管道到另一个命令的方法。

以下命令将标准输出 "Hello" 管道到启动的 Deno 进程的标准输入：

echo Hello | deno run main.ts

要管道标准输出和标准错误，请使用 |&：

deno eval 'console.log(1); console.error(2);' |& deno run main.ts

命令替换 Jump to heading

$(command) 语法提供了一种在执行的其他命令中使用命令输出的方法。

例如，要将获取最新 git 修订版的输出提供给另一个命令，您可以这样做：

deno run main.ts $(git rev-parse HEAD)

另一个示例使用 shell 变量：

REV=$(git rev-parse HEAD) && deno run main.ts $REV && echo $REV

取反退出码 Jump to heading

要取反退出码，请在命令前添加感叹号和空格：

# 将退出码从 1 改为 0
! deno eval 'Deno.exit(1);'

重定向 Jump to heading

重定向提供了一种将标准输出和/或标准错误管道到文件的方法。

例如，以下命令将 deno run main.ts 的 标准输出 重定向到文件系统中的 file.txt：

deno run main.ts > file.txt

要重定向 标准错误，请使用 2>：

deno run main.ts 2> file.txt

要同时重定向标准输出 和 标准错误，请使用 &>：

deno run main.ts &> file.txt

要追加到文件，而不是覆盖现有文件，请使用两个右尖括号而不是一个：

deno run main.ts >> file.txt

抑制命令的标准输出、标准错误或两者的可能性，通过重定向到 /dev/null。这在包含 Windows 的跨平台方式下有效。

# 抑制标准输出
deno run main.ts > /dev/null
# 抑制标准错误
deno run main.ts 2> /dev/null
# 同时抑制标准输出和标准错误
deno run main.ts &> /dev/null

或者将标准输出重定向到标准错误，反之亦然：

# 将标准输出重定向到标准错误
deno run main.ts >&2
# 将标准错误重定向到标准输出
deno run main.ts 2>&1

输入重定向也被支持：

# 将 file.txt 重定向到 gzip 的标准输入
gzip < file.txt

请注意，当前不支持多重重定向。

跨平台 Shebang Jump to heading

从 Deno 1.42 开始，deno task 将以相同的方式执行以 #!/usr/bin/env -S 开头的脚本，适用于所有平台。

例如：

script.ts
#!/usr/bin/env -S deno run
console.log("Hello there!");
deno.json
{
  "tasks": {
    "hi": "./script.ts"
  }
}

然后在 Windows 机器上：

> pwd
C:\Users\david\dev\my_project
> deno task hi
Hello there!

Glob 扩展 Jump to heading

在 Deno 1.34 及以上版本中支持 glob 扩展。这允许以跨平台方式指定 glob 来匹配文件。

# 匹配当前及其子目录中的 .ts 文件
echo **/*.ts
# 匹配当前目录中的 .ts 文件
echo *.ts
# 匹配以 "data" 开头，后跟一个数字，然后以 .csv 结尾的文件
echo data[0-9].csv

支持的 glob 字符包括 *、? 和 [/]。

内置命令 Jump to heading

deno task 附带多个内置命令，在 Windows、Mac 和 Linux 上默认工作相同。

  • cp - 复制文件。
  • mv - 移动文件。
  • rm - 删除文件或目录。
    • 例如: rm -rf [FILE]... - 通常用于递归删除文件或目录。
  • mkdir - 创建目录。
    • 例如. mkdir -p DIRECTORY... - 通常用于创建目录及其所有父级，且如果已存在则不报错。
  • pwd - 打印当前/工作目录的名称。
  • sleep - 延迟指定时间。
    • 例如. sleep 1 以暂停 1 秒，sleep 0.5 以暂停半秒，或者 sleep 1m 以暂停一分钟。
  • echo - 显示一行文本。
  • cat - 连接文件并将其输出到标准输出。没有提供参数时读取和输出标准输入。
  • exit - 导致 shell 退出。
  • head - 输出文件的第一部分。
  • unset - 取消设置环境变量。
  • xargs - 从标准输入构建参数并执行命令。

如果您发现缺少某个命令的有用标志或有任何应该支持的其他命令的建议，请 报告问题 到 deno_task_shell 仓库。

请注意，如果您希望通过非跨平台方式在 Mac 或 Linux 上执行任何这些命令，则可以通过 sh 运行它：sh -c <command>（例如 sh -c cp source destination）。

package.json 支持 Jump to heading

如果发现 deno task 将回退到读取 package.json 文件中的 "scripts" 条目。请注意，Deno 不尊重或支持任何 npm 生命周期事件，如 preinstall 或 postinstall——您必须显式运行您想要执行的脚本条目（例如： deno install --entrypoint main.ts && deno task postinstall）。

你找到了你需要的东西吗？

编辑此页面
隐私政策