快速上手

Deno 最常见的用途是构建 Web 服务。几分钟内即可跑通你的第一个程序。

你的第一个 Deno 程序

创建一个名为 server.ts 的文件，写入以下 TypeScript 代码：

server.ts

Deno.serve((_req: Request) => {
  return new Response("Hello, world!");
});

使用以下命令运行你的服务器：

deno run --allow-net server.ts

服务器将在http://localhost:8000启动一个本地 Web 服务，返回 Hello, world!。

Deno 内置项目脚手架，可一键生成包含 HTTP 服务与测试的标准结构：

deno init my_project

生成的项目结构如下：

text

my_project
├── deno.json      # 项目配置
├── main.ts        # 基于 Deno.serve 的 HTTP 服务
└── main_test.ts   # 测试

进入项目目录并运行。-N 是 --allow-net 的简写，用于授予网络权限：

cd my_project
deno -N main.ts

在 main_test.ts 中编写测试，使用内置的 deno test 运行：

main_test.ts

import { assertEquals } from "jsr:@std/assert@1";

Deno.test("简单加法", () => {
  assertEquals(1 + 2, 3);
});

deno test

权限是显式的

Deno 默认在沙箱中运行代码，没有任何文件、网络或环境访问权限。需要什么权限，就通过--allow-net、--allow-read 等标志显式授予。这是 Deno「安全默认」理念的核心。

无需额外的包管理器配置文件，直接从 npm 或 JSR 安装依赖即可：

deno install npm:express
deno install jsr:@std/assert

随后即可在代码中直接导入使用。关于依赖管理的更多细节，请参阅依赖管理章节。