Files

T

Antigravity Agent 93ec7e9056 [G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00

4.2 KiB

Raw Blame History

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

title

Runtime 비교

Node 가 표준 — 모든 npm 호환. Bun = 빠른 빌드 + 호환, Deno = 보안 + 표준 web API + JSR 레지스트리. 프로덕션 = Node 디폴트, 새 프로젝트 = Bun 시도 가치.

📖 핵심 개념

Node: V8 + libuv. 가장 호환.
Bun: Zig + JSC. 빠른 install / test / bundler 내장.
Deno: V8 + Rust. 권한 모델 + Web 표준 + JSR.
모두 TS native (Bun, Deno) 또는 tsx 필요 (Node).

💻 코드 패턴

Bun

# install
bun install
bun add zod
bun add -d typescript

# 실행
bun run src/index.ts
bun --watch src/index.ts

# test
bun test

# bundler
bun build src/index.ts --outdir dist --target node

// Bun.serve (built-in HTTP)
Bun.serve({
  port: 3000,
  fetch(req) {
    const url = new URL(req.url);
    if (url.pathname === '/health') return new Response('ok');
    return new Response('not found', { status: 404 });
  },
});

// SQLite native
import { Database } from 'bun:sqlite';
const db = new Database('app.db');
db.query('SELECT * FROM users WHERE id = ?').get(id);

Deno

# install (per import)
deno run --allow-net main.ts

# permission flags
deno run --allow-net --allow-read=./data --allow-env main.ts
deno run -A main.ts # all (개발용)

# tasks
deno task dev

// imports — URL 또는 JSR / npm
import { z } from 'npm:zod@3';
import { serve } from 'jsr:@std/http';
import _ from 'https://esm.sh/lodash@4';

// 권한 명시 API
const data = await Deno.readTextFile('./data.json'); // --allow-read

Deno.serve({ port: 3000 }, (req) => new Response('hi'));

Web 표준 (모두 공유)

// 표준 API — Node 18+, Bun, Deno 모두 동일
const r = await fetch('https://api.example.com');
const text = await r.text();

addEventListener('fetch', e => e.respondWith(handle(e.request)));

Node compat (Bun)

// 거의 모든 npm 호환
import express from 'express';        // OK
import { createServer } from 'http';  // OK
import { db } from 'pg';              // OK (native binding 일부 issue)

Deno + Node (compat)

import express from 'npm:express';
import process from 'node:process';

대부분 호환 — 일부 native module 제약.

Test (Bun)

import { test, expect } from 'bun:test';

test('add', () => {
  expect(1 + 1).toBe(2);
});

bun test 가 jest 비슷한 inline matcher.

Test (Deno)

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

Deno.test('add', () => {
  assertEquals(1 + 1, 2);
});

성능 (대략)

작업	Node	Bun	Deno
Install (typical project)	30s	3s	5s
Cold start	100ms	50ms	80ms
Hot HTTP req/s	50K	90K	60K
TS execute	별 도구	native	native

Edge runtime (Cloudflare Workers / Vercel)

Subset of Web Standard APIs only.
Node 호환 = 일부.
Bun / Deno 의 Web API 와 호환성 좋음.

🤔 의사결정 기준

상황	추천
Production 안전	Node.js
빠른 dev cycle	Bun
보안 / 권한	Deno
Edge runtime 호환	Web standard 위주 (Bun / Deno)
큰 npm 의존	Node 또는 Bun
Library publish	Node target + dual ESM/CJS
Self-hosted	Node + PM2 또는 Bun

❌ 안티패턴

Bun 에서 native module 가정: pg / sharp 일부 issue. 검증.
Deno 권한 -A 만 prod: 보안 모델 무의미.
Bun.serve API 가정 prod prod 가까움: 아직 일부 edge case.
Web 표준 API + Node 전용 API 혼용: 호환성 깨짐.
Bun 의 npm install 결과 Node 로 이동: bun lockfile 만 나옴. yarn.lock 도 사용.
Deno 의 https URL import + 안 cache: 매번 fetch.

🤖 LLM 활용 힌트

Production = Node.
Greenfield 빠른 = Bun.
Web 표준 / 보안 = Deno.
모두 fetch / Response / URL standard 동일.

4.2 KiB Raw Blame History