deno

Deno 런타임 CLI. JavaScript/TypeScript 실행, 권한 기반 sandbox, task 실행, 포맷/테스트, 의존성 관리, standalone binary 컴파일, desktop app 빌드를 한 도구로 처리한다.

• deno는 Node.js 대체 런타임으로 JavaScript와 TypeScript를 별도 transpile 단계 없이 직접 실행할 수 있다.
• 기본 실행이 sandbox 기반이라 파일, 네트워크, subprocess 접근은 –allow-* 또는 -A 같은 permission flag로 명시한다.
• 공식 Deno CLI 문서 기준으로 deno desktop은 존재하며, Deno 2.9부터 제공된다.
• 이 작업 환경에는 deno 바이너리가 없어 로컬 –help 원문은 확인하지 못했고, 2026-07-19 기준 공식 Deno 문서를 반영했다.

# macOS / Linux: 공식 installer
curl -fsSL https://deno.land/install.sh | sh
 
# macOS: Homebrew
brew install deno
 
# Node.js가 이미 있는 환경: npm
npm install -g deno
 
# 설치 확인
deno --version

# Windows PowerShell: 공식 installer
irm https://deno.land/install.ps1 | iex
 
# Windows Package Manager
winget install DenoLand.Deno
 
# Scoop
scoop install deno
 
# 설치 확인
deno --version

• 공식 installer의 기본 실행 파일 경로는 macOS/Linux에서 $HOME/.deno/bin/deno, Windows에서 %USERPROFILE%\.deno\bin\deno.exe다.
• 설치 후 deno: command not found가 나오면 새 terminal을 열거나 shell 설정을 다시 읽고, $HOME/.deno/bin이 PATH에 포함되었는지 확인한다.
• 설치 경로를 바꾸려면 installer 실행 전에 DENO_INSTALL 환경 변수를 지정한다.
• npm 설치는 시작 시간이 영향을 받을 수 있어 공식 문서는 installer 사용을 우선 권장한다.
• Linux distribution의 apt, pacman, Snap 등으로 제공되는 package는 community-maintained이며 최신 release보다 늦을 수 있다.
• 설치 후 업데이트: deno upgrade. Homebrew로 설치했다면 brew upgrade deno를 사용한다.

deno main.ts
deno run main.ts
deno task dev
deno serve main.ts
deno fmt
deno test --watch
deno add jsr:@std/assert
deno install -g --allow-net --allow-read jsr:@std/http/file-server
deno compile -A main.ts
deno desktop main.ts

• deno SCRIPT [ARGS…]
• deno run [<switches>…] SCRIPT [ARGS…]
• deno task TASK
• deno serve [<switches>…] [SCRIPT]
• deno fmt [<switches>…] [FILES…]
• deno test [<switches>…] [FILES…]
• deno add PACKAGE…
• deno install [<switches>…] PACKAGE_OR_URL
• deno compile [<switches>…] SCRIPT
• deno desktop [<switches>…] [ENTRYPOINT]

• –allow-read, –allow-net, –allow-env, –allow-run: 런타임 권한을 명시적으로 부여한다.
• -A, –allow-all: 모든 권한을 허용한다. 테스트나 일회성 디버깅 외에는 신중하게 사용한다.
• –watch: 파일 변경 시 run/test/serve 등을 자동 재실행한다.
• –env-file FILE: 환경 변수를 파일에서 로드한다.
• –check: 타입 검사 동작을 제어한다.
• –global, -g: deno install 결과를 전역 executable로 설치한다.
• –name, -n NAME: deno install -g executable 이름을 지정한다.
• –allow-read, –allow-net: deno desktop 빌드 시에도 사용할 수 있고, 허용 권한이 결과 바이너리에 bake 된다.
• –backend webview|cef: 렌더링 엔진 선택. 기본값은 webview.
• –output, -o PATH: 출력 경로 지정. .app, .dmg, .AppImage 같은 확장자로 형식을 결정할 수 있다.
• –icon FILE: 플랫폼별 앱 아이콘 지정.
• –include, –exclude: 번들에 포함하거나 제외할 파일을 조정한다.
• –target TRIPLE: 다른 플랫폼 대상으로 cross-compilation 한다.
• –all-targets: 지원 플랫폼 전체 대상으로 빌드한다.
• –hmr: 개발 중 hot module replacement로 실행한다.
• –inspect, –inspect-wait, –inspect-brk: runtime과 renderer 디버깅에 사용한다.

deno main.ts
deno run --allow-read --allow-net server.ts
deno task dev
deno serve --watch main.ts
deno fmt
deno test --watch
deno add npm:chalk
deno install -g --allow-net --allow-read jsr:@std/http/file-server
deno compile -A -o ./bin/app main.ts
deno desktop main.ts
deno desktop --allow-read --allow-net main.ts
deno desktop --backend webview main.ts
deno desktop --output ./dist/MyApp.dmg main.ts
deno desktop --target aarch64-apple-darwin main.ts
deno desktop --all-targets main.ts
deno desktop --hmr main.ts

• 주요 설정 파일: deno.json
• tasks 블록에서 deno task로 실행할 스크립트를 정의한다.
• imports와 scopes로 dependency alias와 registry 해석을 관리한다.
• nodeModulesDir와 npm compatibility 설정 여부에 따라 Node.js 프로젝트 마이그레이션 체감이 달라질 수 있다.
• desktop 블록에서 앱 이름, identifier, 아이콘, backend, 플랫폼별 output 경로, release URL, error reporting URL을 관리할 수 있다.
• bare deno desktop 또는 deno desktop .은 현재 디렉터리에서 지원되는 framework를 감지해 빌드할 수 있다.

• deno desktop이 보이지 않으면 먼저 Deno 버전을 확인한다. 공식 문서상 이 명령은 v2.9.0부터 제공된다.
• 권한 오류가 나면 –allow-read, –allow-net, –allow-env, –allow-run 중 누락된 permission을 먼저 확인한다.
• npm dependency가 lifecycle script를 요구하면 deno approve-scripts나 관련 정책 검토가 필요할 수 있다.
• desktop binary에 과도한 권한이 baked 되지 않도록 –allow-* 플래그를 최소화한다.
• 플랫폼별 산출물 형식이 다르므로 .app, .dmg, .AppImage 등 기대하는 출력 확장자를 명시하는 편이 안전하다.
• framework auto-detect가 맞지 않으면 entrypoint를 직접 지정해 빌드한다.

• 이 저장소 작업 환경에는 deno 실행 파일이 없어 로컬 검증은 하지 못했다.
• 공식 Deno 문서의 Deno CLI Subcommands 페이지는 2026-06-16에 deno desktop을 포함하고 있다.
• 공식 deno run 문서는 sandbox 기본값, –watch, stdin 실행, deno <file> 축약 실행을 설명한다.
• 공식 deno install 문서는 전역 executable 설치와 –compile 배포 흐름을 문서화한다.
• 공식 deno desktop 페이지는 2026-07-15 확인 기준으로 Available in Deno 2.9와 함께 backend, output, target, HMR, configuration 항목을 문서화하고 있다.

• desktop application 빌드: deno desktop
• 일반 스크립트 실행: deno run
• task runner: deno task
• 자체 HTTP server 실행: deno serve
• standalone binary 생성: deno compile

• Node.js
• node
• npm
• bun

deno --help

Local deno binary was not available in this workspace on 2026-07-15.
 
Verified from official docs:
  * Deno CLI Subcommands
  * deno run
  * deno install
  * deno task
  * deno desktop
 
Relevant documented commands:
  deno <file>
  deno run
  deno serve
  deno task
  deno add
  deno install
  deno compile
  deno fmt
  deno test
  deno desktop

• codex:: 2026-07-19 Moved the page to the node.js:deno:ko head-page path and limited indexmenu to direct children of the current namespace.
• codex:: 2026-07-19 Added official installer, package-manager alternatives, verification, PATH, and update guidance.
• codex:: 2026-07-15 Reframed deno as a Node.js alternative runtime and expanded run, serve, install, compile, permissions, and config coverage from official docs.
• codex:: 2026-07-06 Created deno page and added official deno desktop coverage including version availability, build flags, and configuration notes.