标准库

Deno 提供一组标准模块,它们经过核心团队审计,保证能在 Deno 上工作。

标准库地址:https://deno.land/std@$STD_VERSION/

版本和稳定性

标准库尚不稳定,因此采用与 Deno 不同的版本号。每次 Deno 发布时,标准库也会一起发布。

最新的发布请查阅 https://deno.land/std@$STD_VERSION/https://deno.land/std@$STD_VERSION/version.ts

我们强烈建议:始终使用确定版本的标准库,以避免意外的改动。

例如,连接到随时可能更改的主分支时可能会导致编译错误或意外行为:

// 从 master 导入,这应当避免
import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";

更好的选择是使用不可变且不会更改的 std 库版本:

// 从不可变的 std v0.50.0 导入
import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";

排错 (Troubleshooting)

标准库中的一些模块使用了不稳定的 Deno API。

不用 --unstable 命令行选项运行这些模块会产生一些 TypeScript 错误,表示 Deno 命名空间中不存在一些 API:

// main.ts
import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";

copy("log.txt", "log-old.txt");
$ deno run --allow-read --allow-write main.ts
Compile file:///dev/deno/main.ts
Download https://deno.land/std@$STD_VERSION/fs/copy.ts
Download https://deno.land/std@$STD_VERSION/fs/ensure_dir.ts
Download https://deno.land/std@$STD_VERSION/fs/_util.ts
error: TS2339 [ERROR]: Property 'utime' does not exist on type 'typeof Deno'.
    await Deno.utime(dest, statInfo.atime, statInfo.mtime);
               ~~~~~
    at https://deno.land/std@$STD_VERSION/fs/copy.ts:90:16

TS2339 [ERROR]: Property 'utimeSync' does not exist on type 'typeof Deno'.
    Deno.utimeSync(dest, statInfo.atime, statInfo.mtime);
         ~~~~~~~~~
    at https://deno.land/std@$STD_VERSION/fs/copy.ts:101:10

解决方法是加上 --unstable 选项:

deno run --allow-read --allow-write --unstable main.ts

要确定哪些 API 是不稳定的,请查阅类型声明 lib.deno.unstable.d.ts

这个问题会在不远的将来解决。如果您依赖的特定模块在没有该选项的情况下成功编译,则可以忽略该选项。