VS Code에서 TypeScript 파일을 바로 실행하고 싶다면 Deno를 쓸 수 있습니다. Deno는 JavaScript와 TypeScript를 실행하는 무료 오픈소스 도구이며, 공식 GitHub v2.9.7 릴리스에서 Windows x64용 ZIP을 받을 수 있습니다. 압축을 푼 뒤 명령줄에서 파일을 실행하고, VS Code에는 Denoland 확장을 켜면 됩니다.
처음 설정할 때는 ZIP 안의 deno.exe를 어디에 두었는지와 VS Code 작업 폴더에서 Deno 지원을 켰는지가 중요합니다. 이 글은 Windows x64 파일 선택부터 간단한 hello.ts 실행, 결과 확인까지 순서대로 설명합니다.
TypeScript 파일을 바로 실행하는 명령줄 도구
Deno는 별도의 TypeScript 빌드 명령 없이 .ts 파일을 실행합니다. 편집기에서 코드를 작성하고 터미널에 deno run 파일명.ts를 입력하면 됩니다. 프로젝트가 커지면 deno.json에 작업 명령과 도구 설정을 묶을 수도 있습니다. VS Code의 Denoland 확장을 활성화하면 Deno API와 모듈 해석에 맞는 편집기 도움말을 사용할 수 있습니다.
Deno는 파일 읽기나 네트워크 연결 같은 시스템 접근을 기본으로 허용하지 않습니다. 예를 들어 웹 서버 코드를 실행할 때는 네트워크 권한을 명시해야 합니다. 단순히 콘솔에 글자를 출력하는 예제는 추가 권한이 필요하지 않습니다. 처음부터 모든 권한을 주기보다 프로그램이 실제로 요구하는 권한만 선택하는 편이 설정을 이해하기 쉽습니다.
실행할 파일을 만드는 VS Code와 코드를 실행하는 Deno는 역할이 다릅니다. VS Code의 확장을 설치해도 Windows에서 deno 명령을 찾지 못한다면 Deno 실행 파일의 위치를 먼저 확인해야 합니다. 반대로 터미널에서 deno가 작동해도 편집기에서 Deno용 오류 표시가 없다면 작업 폴더의 확장 설정을 살펴보세요.
프로젝트 설정 파일인 deno.json에는 자주 쓰는 실행 명령을 작업 이름으로 묶을 수 있습니다. 첫 파일을 한 번 실행하는 데 이 파일이 반드시 필요한 것은 아닙니다. 우선 hello.ts 한 개로 터미널 출력과 편집기 설정을 확인한 다음, 반복해서 실행할 명령이 생겼을 때 작업 설정을 추가하면 문제의 원인을 구분하기 쉽습니다.
Deno 공식 문서의 VS Code 작업 폴더 설정 화면
공식 문서 화면에는 VS Code 명령 팔레트에서 Deno: Initialize Workspace Configuration을 선택하는 모습이 보입니다. 이 이미지는 편집기 설정 예시이며 Deno 2.9.7의 버전 표시 화면은 아닙니다.
| 프로그램 | Deno |
| 제작 | Deno Land Inc. |
| 실행 파일 | deno.exe |
| 입력 파일 | JavaScript·TypeScript |
| 편집기 설정 | Denoland VS Code 확장 |
Windows x64 ZIP을 고르고 deno 명령 확인하기
공식 v2.9.7 릴리스에서 deno-x86_64-pc-windows-msvc.zip을 고릅니다. x86_64는 일반적인 Intel·AMD 64비트 Windows PC용입니다. ARM 기반 Windows라면 이름에 aarch64가 들어간 파일이 따로 있으므로 Windows 설정의 시스템 종류를 먼저 확인하세요. macOS와 Linux 파일을 Windows용으로 착각하지 않도록 확장자와 운영체제 이름도 함께 보세요.
ZIP을 풀면 deno 실행 파일이 나옵니다. 공식 수동 설치 안내는 압축을 풀어 실행 파일을 명령 검색 경로(PATH)에 있는 폴더에 두도록 설명합니다. 한 폴더에 압축을 풀고 그 폴더를 사용자 PATH에 추가한 뒤 새 PowerShell 창에서 deno –version을 입력하면 경로가 적용됐는지 확인할 수 있습니다. 기존 창에서는 변경 전 PATH가 남아 있을 수 있으므로 새 창으로 확인하세요.
공식 설치 문서에 따르면 Windows는 10 버전 1709 이상이 필요합니다. 회사 PC에서 PATH를 바꿀 수 없다면 먼저 시스템 관리자 정책을 확인하세요. 이 글은 설치 스크립트 대신 공식 릴리스의 Windows x64 ZIP을 기준으로 합니다. ZIP은 설치 마법사 파일이 아니므로 압축을 푼 위치와 PATH 설정이 설치 과정의 핵심입니다.
릴리스 자산에는 ZIP과 짝을 이루는 .sha256sum 파일도 있습니다. 다운로드가 중간에 끊겼거나 파일이 바뀌지 않았는지 확인하려면 공식 체크섬 파일에 적힌 값과 받은 ZIP의 SHA-256 값을 비교할 수 있습니다. 비교 결과가 다르다면 그 ZIP으로 진행하지 말고 파일을 다시 받아 확인하세요. 단순히 파일 이름과 용량이 비슷하다는 것만으로 같은 파일이라고 판단할 수는 없습니다.
- Windows의 시스템 종류가 x64인지 확인합니다.
- 공식 v2.9.7 릴리스에서 Windows x64 ZIP을 받습니다.
- 압축을 풀어 PATH를 설정하고 새 PowerShell에서 deno –version을 확인합니다.
VS Code에서 Deno 작업 폴더 켜기
VS Code의 확장 탭에서 Deno를 검색하고 게시자가 Denoland인 확장을 설치합니다. 프로젝트 폴더를 연 뒤 Ctrl+Shift+P로 명령 팔레트를 열고 Deno: Initialize Workspace Configuration을 선택하세요. 공식 문서는 이 명령이 작업 폴더에 .vscode/settings.json을 만들고 deno.enable 값을 true로 설정한다고 안내합니다.
같은 PC에서 Node.js 프로젝트도 작업한다면 모든 폴더에 무조건 Deno를 켜기보다 현재 Deno 프로젝트 폴더에서만 설정하는 편이 혼동을 줄입니다. VS Code가 다른 폴더를 열고 있으면 원하는 프로젝트가 아닌 곳에 설정 파일이 생길 수 있습니다. 명령을 실행하기 전 왼쪽 탐색기에 열린 폴더 이름을 확인하세요.
확장 화면은 편집기 기능을 위한 것이고 실제 TypeScript 실행은 Deno 명령줄에서 이루어집니다. VS Code 터미널을 새로 열어 deno –version을 입력해 보세요. 명령이 인식되지 않는다면 확장을 다시 설치하기보다 ZIP을 풀어 둔 폴더와 PATH부터 점검해야 합니다.
명령 팔레트에서 초기화를 마친 뒤 .vscode/settings.json 파일을 열면 deno.enable 값이 true인지 직접 볼 수 있습니다. 이 설정은 현재 작업 폴더에 적용되므로 다른 폴더로 옮겨 새 프로젝트를 시작할 때는 그 폴더에서도 Deno를 활성화해야 합니다. 같은 이름의 확장이 보이더라도 게시자가 Denoland인지 확인하면 공식 확장을 고르기 쉽습니다.
- VS Code에서 프로젝트 폴더를 엽니다.
- Denoland의 Deno 확장을 설치합니다.
- Ctrl+Shift+P에서 Deno: Initialize Workspace Configuration을 실행합니다.
hello.ts를 실행하고 출력 확인하기
작업 폴더에 hello.ts 파일을 만들고 console.log("안녕하세요"); 한 줄을 입력해 저장합니다. VS Code의 터미널에서 현재 위치가 그 파일이 있는 폴더인지 확인한 다음 deno run hello.ts를 입력하세요. Deno 공식 실행 문서는 TypeScript 파일을 이 명령으로 바로 실행할 수 있다고 설명합니다.
실행 결과로 터미널에 안녕하세요가 표시되면 파일 저장부터 실행까지 연결된 것입니다. 파일을 고친 뒤 같은 명령을 다시 입력하면 변경한 결과를 확인할 수 있습니다. '파일을 찾을 수 없음' 오류가 나오면 현재 터미널 폴더와 파일명을 먼저 비교하세요. VS Code 편집기에서 파일을 열어 둔 것만으로 터미널의 현재 위치가 자동으로 바뀌지는 않습니다.
간단한 콘솔 출력에는 별도 시스템 권한이 필요하지 않습니다. 이후 파일 읽기나 웹 요청을 추가한 코드에서 권한 요청이 나타나면 그때 필요한 경로 또는 네트워크 권한을 지정하세요. 공식 문서의 –allow-* 옵션은 기능별로 범위를 정할 수 있습니다. 오류를 없애려고 모든 권한을 주는 -A를 습관처럼 쓰지 않는 것이 좋습니다.
출력만 확인했다면 같은 폴더에서 deno check hello.ts로 타입 오류도 검사해 볼 수 있습니다. 공식 문서는 deno run이 코드를 실행하는 일과 타입 검사하는 일을 분리한다고 설명합니다. 예제에 입력값이나 함수의 타입을 추가할 때는 실행 결과가 보인다는 이유만으로 타입 검사를 건너뛰지 마세요. deno check는 코드를 실행하지 않고 오류를 찾아줍니다.
- 프로젝트 폴더에 hello.ts를 만들고 console.log("안녕하세요");를 저장합니다.
- VS Code 터미널에서 deno run hello.ts를 입력합니다.
- 터미널에 안녕하세요가 출력되는지 확인합니다.
명령이 안 되거나 VS Code에서 오류가 보일 때
PowerShell에서 deno 명령을 찾지 못하면 ZIP을 푼 폴더에 deno.exe가 있는지 확인하세요. 그 폴더가 사용자 PATH에 들어 있는지 살펴본 뒤 터미널을 닫고 새로 엽니다. deno –version이 정상이라면 그다음에 VS Code 터미널에서 같은 명령을 확인하세요. 시스템 PATH와 편집기 터미널이 갱신된 시점이 다를 수 있습니다.
터미널에서는 실행되는데 VS Code 편집기에서 Deno API에 밑줄이 보이면 Denoland 확장이 설치됐는지와 현재 작업 폴더에서 Deno 지원을 초기화했는지 확인합니다. .vscode/settings.json의 deno.enable 값이 true인지 보고, 다른 폴더의 설정만 바꾼 것은 아닌지도 확인하세요. 확장을 켠 뒤에는 편집기 창을 다시 열어 상태를 살필 수 있습니다.
파일이나 네트워크에 접근하는 코드는 기본 권한 때문에 멈출 수 있습니다. 오류 메시지가 요청하는 기능을 읽고 –allow-read 또는 –allow-net처럼 필요한 권한만 선택하세요. 예를 들어 로컬 파일을 읽는 코드와 웹 서버를 여는 코드는 요구하는 권한이 다릅니다. 설치 자체의 오류와 실행 중 권한 오류를 구분하면 해결할 위치가 분명해집니다.
편집기에서 문제가 없어 보이는데 명령줄에서 타입 검사 결과가 다르다면 현재 폴더와 적용된 설정을 살펴보세요. 프로젝트마다 deno.json과 .vscode/settings.json이 다를 수 있습니다. 여러 프로젝트를 한 VS Code 창에 열어 두었다면 어느 폴더의 hello.ts를 실행하고 있는지 파일 경로를 다시 확인해야 합니다. 작은 예제를 별도 폴더에서 성공시킨 뒤 실제 프로젝트 설정으로 옮겨 가면 원인을 좁히기 쉽습니다.
- deno –version이 안 되면 실행 파일 폴더와 PATH를 확인합니다.
- 편집기 밑줄은 Denoland 확장과 작업 폴더 설정을 확인합니다.
- 실행 중 권한 오류는 필요한 –allow-* 옵션을 골라 다시 시도합니다.
자주 묻는 질문
Deno는 무료인가요?
네. 공식 저장소의 MIT 라이선스를 확인할 수 있고 Windows용 ZIP을 공식 GitHub 릴리스에서 무료로 받을 수 있습니다.
Windows에서는 어떤 ZIP을 선택하나요?
Intel·AMD 64비트 PC는 deno-x86_64-pc-windows-msvc.zip입니다. ARM64 PC는 이름에 aarch64가 들어간 Windows ZIP을 고릅니다.
VS Code 확장만 설치하면 실행되나요?
아니요. 확장은 편집기 지원을 켭니다. TypeScript를 실행하려면 Deno 실행 파일도 받아 deno 명령이 인식되게 해야 합니다.
TypeScript를 미리 JavaScript로 변환해야 하나요?
간단한 .ts 파일은 deno run hello.ts처럼 바로 실행할 수 있습니다. 이 글의 첫 콘솔 예제에는 별도 빌드 명령이 필요하지 않습니다.
권한 오류가 나오면 어떻게 하나요?
실행한 코드가 파일·네트워크 등 무엇을 쓰는지 보고 해당 –allow-* 옵션을 지정하세요. 모든 권한을 주는 -A부터 사용할 필요는 없습니다.
파일을 실행한 뒤 편집기 설정을 확인하세요
Deno 2.9.7의 Windows x64 ZIP을 받아 풀고 deno –version이 보이면 실행 준비가 된 것입니다. VS Code에서는 Denoland 확장을 설치하고 현재 프로젝트 폴더의 Deno 설정을 켜세요. 실행 파일과 편집기 확장은 각각 확인해야 합니다.
hello.ts에 한 줄을 적고 deno run hello.ts로 출력이 보이는지 확인하면 첫 작업을 마칠 수 있습니다. 다음에 파일 읽기나 서버 코드를 실행할 때는 오류 메시지에 맞춰 필요한 권한만 지정하세요.
공식 자료와 확인일
Deno 공식 제품과 TypeScript 실행 안내 · Deno 2.9.7 공식 릴리스 · Deno 공식 Windows 수동 설치 안내 · Deno 공식 VS Code 설정 안내 · Deno 공식 실행·권한 문서 · Deno 공식 타입 검사 문서 | 2026년 10월 12일 확인
