Deno 2 完全ガイド【2026年最新】｜Node.js/npm 互換・JSR・dx コマンド・Workspaces・Temporal API・Permission System・Deno Deploy・Node から Deno への移行まで解説

# macOS / Linux
curl -fsSL https://deno.land/install.sh | sh

# Homebrew
brew install deno

# Windows（PowerShell）
irm https://deno.land/install.ps1 | iex

# バージョン確認
deno --version
# deno 2.7.x (stable, release)
# v8 14.x
# typescript 5.x

# アップグレード
deno upgrade

# 対話形式で雛形生成
deno init my-app
# 生成物:
# ├── deno.json          ← Deno の設定ファイル
# ├── main.ts
# └── main_test.ts

cd my-app
deno run main.ts
deno test               # テストランナー組込み

# Hello world 直接実行（TS ファイルをそのまま）
echo 'console.log("hello deno")' > hello.ts
deno run hello.ts

// npm: 指定子: Deno が自動で npm からダウンロード
import chalk from "npm:chalk@5.3.0";
import express from "npm:express@4.21.2";
import { z } from "npm:zod@3.23.8";

console.log(chalk.blue("hello"));

const app = express();
app.get("/", (_req, res) => res.json({ ok: true }));
app.listen(3000);

// 型もそのまま効く
const Schema = z.object({ name: z.string() });

import { readFile } from "node:fs/promises";
import path from "node:path";
import { createHash } from "node:crypto";

const file = await readFile(path.resolve("./data.txt"), "utf-8");
const hash = createHash("sha256").update(file).digest("hex");
console.log(hash);

// package.json（Node.js プロジェクトそのまま）
{
  "name": "my-app",
  "type": "module",
  "dependencies": {
    "hono": "^4.9.1",
    "zod": "^3.23.8"
  },
  "scripts": {
    "dev": "deno run --allow-net src/server.ts"
  }
}

# node_modules が未生成なら自動生成される
deno install

# package.json の scripts を実行
deno task dev

# 既存 Express / Next.js / Vite プロジェクトが大半そのまま動く

# すべての依存をインストール（node_modules 生成）
deno install                       # 省略可: deno i

# パッケージ追加
deno add npm:hono                  # package.json または deno.json に書き込み
deno add npm:zod@3.23
deno add jsr:@std/path              # JSR から

# 削除
deno remove npm:hono

# 古い依存の検出
deno outdated

# 更新
deno update hono

# ロックファイル: deno.lock（JSON）
# → Git にコミット必須。CI は --frozen で厳密モード
deno install --frozen

// JSR の Standard Library を使う
import { walk } from "jsr:@std/fs@1";
import { parseArgs } from "jsr:@std/cli@1/parse-args";

const args = parseArgs(Deno.args, { boolean: ["verbose"] });

for await (const entry of walk("./src", { exts: [".ts"] })) {
  if (args.verbose) console.log(entry.path);
}

# 公式 CLI: deno publish
# 事前に jsr.io で scope を取得し、deno.json で name と version を設定
cat deno.json
# {
#   "name": "@username/my-util",
#   "version": "1.0.0",
#   "exports": "./mod.ts"
# }

# 公開（GitHub Actions でも npx jsr publish で可）
deno publish

# npx 相当。ダウンロード前に確認プロンプトが出る
dx cowsay "deno is fast"
dx create-react-app my-app
dx @astrojs/upgrade latest

# JSR パッケージの実行も OK
dx jsr:@std/cli@1/parse-args --help

# 依存に追加せずに 1 回限り実行
dx prettier . --write

{
  "workspace": [
    "./packages/ui",          // deno.json を持つ純 Deno パッケージ
    "./packages/api",         // package.json を持つ Node 互換パッケージ
    "./apps/web"              // 同上
  ],
  "imports": {
    "@myorg/shared": "./packages/shared/mod.ts"
  }
}

# すべてのワークスペースでテスト
deno task --recursive test

# 特定パッケージのみ
deno task --filter=@myorg/api dev

# ネットワーク（全許可）
deno run --allow-net server.ts

# 特定ホストのみ許可（推奨）
deno run --allow-net=api.github.com,db.example.com:5432 app.ts

# ファイル読み込み（特定ディレクトリのみ）
deno run --allow-read=./public,./data app.ts

# 環境変数（特定キーのみ）
deno run --allow-env=DATABASE_URL,API_KEY app.ts

# サブプロセス実行（特定コマンドのみ）
deno run --allow-run=git,ls app.ts

# すべて許可（開発時のみ。本番禁止）
deno run -A app.ts

# 実行時に確認プロンプト（--allow-* を付けない場合）
deno run server.ts
# ⚠️  Deno requests net access to "127.0.0.1:3000". Allow? [y/n (y = yes allow, n = no deny)]

// Permissions API で動的に確認
const status = await Deno.permissions.request({
  name: "read",
  path: "./secrets",
});
if (status.state !== "granted") {
  console.error("権限が足りません");
  Deno.exit(1);
}

// 既存の許可状態を問い合わせ
const netStatus = await Deno.permissions.query({ name: "net", host: "api.example.com" });

# フォーマット（TypeScript / JavaScript / JSON / Markdown / HTML / CSS / YAML 対応）
deno fmt
deno fmt --check          # CI で差分があったら fail

# リンター
deno lint
deno lint --rules         # 有効ルール一覧

# ルールカスタマイズ（deno.json）
# {
#   "fmt":  { "lineWidth": 100, "indentWidth": 2, "useTabs": false },
#   "lint": { "rules": { "exclude": ["no-explicit-any"] } }
# }

# *_test.ts / *.test.ts を自動実行
deno test

# カバレッジ付き
deno test --coverage
deno coverage --lcov > coverage.lcov

# 並列実行
deno test --parallel

# Node.js の node:test ライクなテストも動く
# import { test } from "node:test";

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

Deno.test("add function", () => {
  assertEquals(2 + 3, 5);
});

Deno.test("async test", async () => {
  const res = await fetch("https://httpbin.org/get");
  assertEquals(res.status, 200);
  await res.body?.cancel();
});

// スナップショット
import { assertSnapshot } from "jsr:@std/testing@1/snapshot";
Deno.test("snapshot", async (t) => {
  await assertSnapshot(t, { user: "alice", age: 25 });
});

# ベンチマーク
deno bench

# Single-file executable（Node.js 不要のバイナリ化）
deno compile --output mycli --allow-net src/cli.ts

# クロスコンパイル
deno compile --target x86_64-unknown-linux-gnu --output mycli-linux src/cli.ts
deno compile --target x86_64-pc-windows-msvc  --output mycli.exe     src/cli.ts
deno compile --target aarch64-apple-darwin    --output mycli-mac     src/cli.ts
deno compile --target aarch64-pc-windows-msvc --output mycli-winarm  src/cli.ts  # 2.7+

// ファイルシステム
import { walk, copy, ensureDir } from "jsr:@std/fs@1";

// パス操作
import { join, resolve, extname } from "jsr:@std/path@1";

// 非同期ユーティリティ
import { debounce, pooledMap } from "jsr:@std/async@1";

// CLI 引数パース
import { parseArgs } from "jsr:@std/cli@1/parse-args";

// 暗号ハッシュ
import { crypto } from "jsr:@std/crypto@1";

// JSON schema + 型ガード
import { assert, assertEquals } from "jsr:@std/assert@1";

// URL パターンマッチ
import { UrlPattern } from "jsr:@std/http@1/unstable-url-pattern";

# すべての依存を GitHub Advisory Database で検査
deno audit

# 重大度で絞り込み
deno audit --severity=high

# JSON 出力（CI 向け）
deno audit --json

# 依存の postinstall / preinstall などを承認制に
deno approve-scripts

# インタラクティブに実行を許可
#   ✓ sharp: rebuild native binary (必要)
#   ✗ telemetry-package: unwanted script (拒否)

// 2.7 以降はフラグなしで使える
const now = Temporal.Now.plainDateTimeISO();
console.log(now.toString());          // 2026-04-22T09:30:45.123

// 不変・タイムゾーン対応
const start = Temporal.PlainDate.from("2026-04-01");
const end   = Temporal.PlainDate.from("2026-04-22");
const days  = start.until(end).days;  // 21

// 厳密な計算
const meeting = Temporal.ZonedDateTime.from({
  timeZone: "Asia/Tokyo",
  year: 2026, month: 4, day: 22, hour: 14, minute: 30,
});
const utc = meeting.withTimeZone("UTC");

# deployctl CLI
deno install -Arf jsr:@deno/deployctl

# デプロイ
deployctl deploy --project=my-app src/server.ts

# 本番環境変数
deployctl env set DATABASE_URL=... --project=my-app

FROM denoland/deno:2.7.0 AS deps
WORKDIR /app
COPY deno.json deno.lock ./
RUN deno install --frozen

FROM denoland/deno:2.7.0
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# 権限は明示的に絞る（本番では -A を使わない）
USER deno
EXPOSE 8000
CMD ["run", "--allow-net", "--allow-env=DATABASE_URL", "src/server.ts"]

# 実行可能バイナリを作成（Deno ランタイムを内包）
deno compile \
  --allow-net --allow-env \
  --target x86_64-unknown-linux-gnu \
  --output server-linux \
  src/server.ts

# 60MB 程度の単一ファイル。scp して実行するだけ
scp server-linux user@host:/opt/app/
ssh user@host "/opt/app/server-linux"