命令行界面

Deno CLI 是面向 JavaScript 和 TypeScript 项目的全能工具链： 它可以运行和测试代码、进行格式化和代码检查、管理依赖、编译为 独立二进制文件，以及更多功能。每个子命令（run、test、fmt、 compile 等）都有自己的标志；运行 deno help 或 deno <subcommand> --help 查看它们。

有关子命令和标志的完整列表，请参阅 CLI reference。本页涵盖你会很快接触到的模式：如何运行代码、如何传递参数，以及如何使用监视模式。

运行脚本 Jump to heading#

你可以通过指定其相对于当前工作目录的路径来运行本地 TypeScript 或 JavaScript 文件：

deno run main.ts

Deno 支持直接从 URL 运行脚本。这在快速测试或运行代码而无需先下载它时特别有用：

deno run https://docs.deno.com/examples/scripts/hello_world.ts

你还可以通过标准输入将脚本通过管道传递。这对于与其他命令行工具集成或动态生成脚本很有用：

cat main.ts | deno run -

传递脚本参数 Jump to heading#

脚本参数是在从命令行运行脚本时可以传递给脚本的附加参数。这些参数可以用于根据运行时提供的输入自定义程序的行为。参数应在脚本名称 之后 传递。

为了测试这一点，我们可以制作一个将记录传递给它的参数的脚本：

console.log(Deno.args);

当我们运行该脚本并传递一些参数时，它将记录这些参数到控制台：

$ deno run main.ts arg1 arg2 arg3
[ "arg1", "arg2", "arg3" ]

对于超出简单平面列表的情况，请使用 parseArgs from jsr:@std/cli 或 parseArgs from node:util 解析参数。

参数和标志顺序 Jump to heading#

这会导致以下陷阱：

# 好的。我们为 net_client.ts 授予网络权限。
deno run --allow-net net_client.ts

# 不好的！--allow-net 被传递给 Deno.args，抛出网络权限错误。
deno run net_client.ts --allow-net

监视模式 Jump to heading#

你可以将 --watch 标志提供给 deno run、deno test、deno compile 和 deno fmt 来启用内置的文件监视器。监视器在检测到源文件中的更改时启用应用程序的自动重载。在开发过程中这特别有用，因为它允许你立即看到更改的效果，而无需手动重启应用程序。

所监视的文件将取决于使用的子命令：

• 对于 deno run、deno test 和 deno compile，将监视入口文件及其静态导入的所有本地文件。
• 对于 deno fmt，将监视作为命令行参数指定的所有本地文件和目录（如果未传递特定文件/目录，则监视工作目录）。

deno run --watch main.ts
deno test --watch
deno fmt --watch

你可以通过提供 --watch-exclude 标志来排除路径或模式被监视。语法为 --watch-exclude=path1,path2。例如：

deno run --watch --watch-exclude=file1.ts,file2.ts main.ts

这将排除 file1.ts 和 file2.ts 被监视。

要排除一个模式，请记得将其用引号括起来，以防止你的 shell 展开通配符：

deno run --watch --watch-exclude='*.js' main.ts

接下来去哪里 Jump to heading#

有关本页仅略作提示的主题的更深入内容，请参阅：

• CLI reference: 每个子命令和标志。
• Security and permissions: 完整介绍 --allow-* 和 --deny-* 标志。
• Modules and dependencies: lockfile、 导入以及完整性检查。
• TypeScript: Deno 何时进行类型检查以及如何 控制它。
• Debugging: --inspect 系列标志 以及如何附加调试器。