# Deno 中文生态中心

Deno 是一个 JavaScript、TypeScript 与 WebAssembly 运行时。它直接运行 TypeScript，默认隔离文件、网络、环境变量和子进程访问，并在单个 CLI 中提供依赖管理、格式化、Lint、测试、文档和编译工具。

本站不镜像 [Deno 官方文档](https://docs.deno.com)，而是为中文开发者整理迁移路线、框架选型、生产边界与可直接实践的项目蓝图。

## 选择你的任务

<Cards>
  <Card title="第一次使用 Deno" description="安装、权限模型和一个可测试的 HTTP 服务。" href="/docs/getting-started/quickstart" />
  <Card title="从 Node.js 迁移" description="保留 package.json，先验证再逐步采用 Deno 工具链。" href="/docs/migration/from-node" />
  <Card title="用 Fresh 构建全栈应用" description="基于 Fresh 2 的路由、Island、中间件与部署路径。" href="/docs/web/fresh" />
  <Card title="用 Hono / Oak 构建 API" description="按 runtime 可移植性与 middleware 模型选择。" href="/docs/web" />
  <Card title="连接数据库" description="PostgreSQL、Drizzle、SQLite、Redis、MongoDB、Supabase 与 KV。" href="/docs/database" />
  <Card title="构建 MCP 与 Agent" description="OpenAI Responses API、MCP Server、工具权限与 Agent 循环。" href="/docs/ai" />
  <Card title="配置最小权限" description="为网络、文件、环境变量和子进程分别授权。" href="/docs/core/permissions" />
  <Card title="管理 JSR 与 npm 依赖" description="理解 deno.json、deno.lock、缓存与 node_modules。" href="/docs/core/dependencies" />
  <Card title="部署到生产" description="在 Deno Deploy、容器和通用云平台之间选择。" href="/docs/deploy" />
  <Card title="构建 AI 服务" description="流式响应、密钥权限、工具调用与观测。" href="/docs/ai/building-ai-apps" />
  <Card title="保护依赖供应链" description="deno ci、audit、依赖年龄、脚本审批与 vendor。" href="/docs/core/supply-chain" />
  <Card title="构建桌面应用" description="使用 Deno 2.9 的 deno desktop、跨平台分发与更新。" href="/docs/core/desktop" />
  <Card title="只查命令" description="CLI、deno.json 和常见排错顺序。" href="/docs/reference/cli-and-config" />
  <Card title="选择实战项目" description="Fresh 博客、MCP Server、Cron 服务与图片处理 API。" href="/docs/projects" />
</Cards>

## 能力地图

| 目标 | 首选入口 | 文档 |
| --- | --- | --- |
| 运行 TypeScript | `deno run main.ts` | [运行时](/docs/core/runtime) |
| 收紧系统访问 | `--allow-*` / `--deny-*` | [权限](/docs/core/permissions) |
| 添加 JSR 或 npm 包 | `deno install <pkg>` | [依赖](/docs/core/dependencies) |
| 格式化、Lint、类型检查 | `deno fmt && deno lint && deno check` | [内置工具](/docs/core/tooling) |
| 执行测试 | `deno test` | [测试](/docs/core/testing) |
| 可复现安装与安全扫描 | `deno ci && deno audit` | [供应链安全](/docs/core/supply-chain) |
| 统一项目命令 | `deno task <name>` | [CLI 与配置](/docs/reference/cli-and-config) |
| 构建全栈页面 | Fresh 2 | [Fresh 教程](/docs/web/fresh) |
| 构建跨 runtime API | Hono | [Hono 教程](/docs/web/hono) |
| 连接 PostgreSQL | postgres.js / Drizzle | [数据库](/docs/database/postgres-drizzle) |
| 暴露 AI 工具 | MCP TypeScript SDK | [MCP Server](/docs/ai/mcp-server) |
| 分发单文件程序 | `deno compile` | [编译分发](/docs/core/compile) |
| 搭建 CI 流水线 | `setup-deno` + `deno ci` | [CI/CD 实战](/docs/deploy/ci-cd) |
| 管理环境变量 | `--env-file` / `--allow-env` | [环境变量](/docs/core/env-variables) |
| 在三个运行时之间选型 | 维度对比 | [Deno vs Node vs Bun](/docs/reference/deno-vs-node-bun) |

<Callout type="info" title="版本表达">
本文以 Deno 2.x 为稳定基线。涉及小版本、预览 API 或托管平台行为时，先运行 `deno --version`，再核对官方对应页面与发布说明。
</Callout>

每个页面 URL 都可追加 `.md` 获取 Markdown；全站另有 [`/llms.txt`](/llms.txt) 与 [`/llms-full.txt`](/llms-full.txt)。