命令行界面

Deno 是一个命令行程序。您应该熟悉一些简单的命令，因为您已经按照示例操作并已经了解了 shell 使用的基本知识。

有多种方法可以查看主要帮助文本

# Using the subcommand.
deno help

# Using the short flag -- outputs the same as above.
deno -h

# Using the long flag -- outputs more detailed help text where available.
deno --help

Deno 的 CLI 基于子命令。上面的命令应该向您显示支持的子命令列表，例如 deno compile。要查看特定于子命令的帮助，例如 compile，您可以类似地运行以下命令之一

deno help compile
deno compile -h
deno compile --help

每个子命令的详细指南可以在这里找到。

脚本来源

Deno 可以从多个来源获取脚本，包括文件名、URL 和 '-' 用于从标准输入读取文件。后者对于与其他应用程序集成很有用。

deno run main.ts
deno run https://mydomain.com/main.ts
cat main.ts | deno run -

脚本参数

除了 Deno 运行时标志之外，您还可以通过在脚本名称 **之后** 指定它们来将用户空间参数传递给要运行的脚本。

deno run main.ts a b -c --quiet

// main.ts
console.log(Deno.args); // [ "a", "b", "-c", "--quiet" ]

**请注意，在脚本名称之后传递的任何内容都将作为脚本参数传递，而不是作为 Deno 运行时标志使用。** 这会导致以下陷阱

# Good. We grant net permission to net_client.ts.
deno run --allow-net net_client.ts

# Bad! --allow-net was passed to Deno.args, throws a net permission error.
deno run net_client.ts --allow-net

有些人认为这很不寻常

非位置标志的解析方式取决于其位置。

但是

这是区分运行时标志和脚本参数最合乎逻辑和最符合人体工程学的方式。
实际上，这与任何其他流行的运行时的行为相同。
- 尝试 node -c index.js 和 node index.js -c。第一个将仅根据 Node 的 -c 标志对 index.js 进行语法检查。第二个将执行 index.js，并将 -c 传递给 require("process").argv。

存在一些在相关子命令之间共享的标志逻辑组。我们将在下面讨论这些。

监视模式

您可以为 deno run、deno test、deno compile 和 deno fmt 提供 --watch 标志以启用内置文件监视器。监视的文件取决于使用的子命令

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

每当监视的文件之一在磁盘上发生更改时，程序将自动重新启动/格式化/测试/捆绑。

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

您可以通过提供 --watch-exclude 标志来排除路径的监视。此标志仅适用于 deno run。语法为 --watch-exclude=path1,path2。例如

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

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

热模块替换模式

您可以使用 --unstable-hmr 标志与 deno run 一起使用来启用热模块替换模式。运行时将尝试就地更新程序，而不是重新启动程序。如果就地更新失败，程序仍将重新启动。

deno run --unstable-hmr main.ts

当触发热模块替换时，运行时将分派一个类型为 hmr 的 CustomEvent，该事件将在其 detail 对象中包含 path 属性。您可以监听此事件并执行模块更新时需要执行的任何其他逻辑（例如，通过 WebSocket 连接通知浏览器）。

addEventListener("hmr", (e) => {
  console.log("HMR triggered", e.detail.path);
});

完整性标志（锁定文件）

影响可以将资源下载到缓存的命令：deno cache、deno run、deno test、deno doc 和 deno compile。

--lock <FILE>    Check the specified lock file
--lock-write     Write lock file. Use with --lock.

在此处了解更多信息here.

缓存和编译标志

影响可以填充缓存的命令：deno cache、deno run、deno test、deno doc 和 deno compile。除了上述标志外，还包括影响模块解析、编译配置等的标志。

--config <FILE>               Load configuration file
--import-map <FILE>           Load import map file
--no-remote                   Do not resolve remote modules
--reload=<CACHE_BLOCKLIST>    Reload source code cache (recompile TypeScript)
--unstable                    Enable unstable APIs

运行时标志

影响执行用户代码的命令：deno run 和 deno test。这些包括所有上述标志以及以下标志。

类型检查标志

您可以使用以下命令对代码进行类型检查（不执行代码）

> deno check main.ts

您也可以使用 --check 参数对 deno run 进行类型检查，以在执行之前对代码进行类型检查

> deno run --check main.ts

此标志影响 deno run、deno eval、deno repl 和 deno cache。下表描述了各种子命令的类型检查行为。这里“本地”表示只有来自本地代码的错误会导致类型错误，从 https URL（远程）导入的模块可能存在未报告的类型错误。（要打开所有模块的类型检查，请使用 --check=all。）

子命令	类型检查模式
`deno bench`	📁 本地
`deno cache`	❌ 无
`deno 检查`	📁 本地
`deno 编译`	📁 本地
`deno 评估`	❌ 无
`deno repl`	❌ 无
`deno 运行`	❌ 无
`deno 测试`	📁 本地

权限标志

这些列在这里.

其他运行时标志

更多影响执行环境的标志。

--cached-only                Require that remote dependencies are already cached
--inspect=<HOST:PORT>        activate inspector on host:port ...
--inspect-brk=<HOST:PORT>    activate inspector on host:port and break at ...
--inspect-wait=<HOST:PORT>   activate inspector on host:port and wait for ...
--location <HREF>            Value of 'globalThis.location' used by some web APIs
--prompt                     Fallback to prompt if required permission wasn't passed
--seed <NUMBER>              Seed Math.random()
--v8-flags=<v8-flags>        Set V8 command line options. For help: ...

自动完成

您可以使用 Fig 为 Deno 获取 IDE 风格的自动完成。它适用于 bash、zsh 和 fish。

要安装，请运行

brew install fig

命令行界面

脚本来源​

脚本参数​

监视模式​

热模块替换模式​

完整性标志（锁定文件）​

缓存和编译标志​

运行时标志​

类型检查标志​

权限标志​

其他运行时标志​

自动完成​