이 편에서 만드는 파일

todo-cli/
├── package.json   (+)
└── src/
    └── index.js   (+)

개념 정리

이 과목 전체에서 todo-cli라는 할 일 관리 CLI(명령행 프로그램)를 편마다 조금씩 완성합니다. 시작하기 전에 지금 다루는 언어와 실행 환경의 이름부터 정리합니다.

브라우저용 JavaScript에는 document, window 같은 DOM API가 있지만 Node.js에는 없습니다. 대신 Node.js는 process, fs 같은 시스템 API를 제공합니다. 이 과목은 Node.js 22(2026년 기준 최신 LTS)를 기준으로 진행합니다. LTS(Long Term Support)는 장기간 보안 패치를 제공하는 안정 버전 계열을 뜻하며, 실무 서버·CLI 도구는 보통 LTS 버전을 기준으로 배포합니다.

npm 명령 정리

todo-cli는 외부 패키지 없이 Node.js 내장 모듈(fs/promises, node:test 등)만으로 완성합니다. 그래서 package.json에 dependencies 항목이 생기지 않습니다.

package.json 핵심 필드

"type": "module"을 지정하지 않으면 Node.js는 .js 파일을 CommonJS(require/module.exports)로 해석합니다. 이 과목은 처음부터 끝까지 ESM만 사용하므로 반드시 지정합니다.

실습

mkdir todo-cli
cd todo-cli
npm init -y

// package.json
{
  "name": "todo-cli",
  "version": "0.1.0",
  "description": "터미널에서 쓰는 할 일 관리 CLI",
  "type": "module",
  "main": "src/index.js",
  "bin": {
    "todo": "./src/index.js"
  },
  "scripts": {
    "start": "node src/index.js",
    "test": "node --test"
  }
}

// src/index.js
console.log('todo-cli 준비 완료');

node src/index.js

확인

• 터미널에 아래처럼 출력되면 성공입니다.

todo-cli 준비 완료

• npm run start로 실행해도 같은 결과가 나오는지 확인합니다(scripts.start가 node src/index.js를 대신 실행).
• node -v 실행 결과가 v22 이상인지 확인합니다.

직접 해보기

1. package.json의 description 필드를 원하는 문장으로 바꿔봅니다.
2. src/index.js에 console.log(process.version)을 한 줄 추가해 현재 Node.js 버전을 함께 출력해봅니다.

// src/index.js
console.log('todo-cli 준비 완료');
console.log('Node 버전:', process.version);

자주 하는 실수

확인 문제

참고 자료

• Node.js Docs - process.argv 
• Node.js — Node.js 22 is now available! 
• Node.js Docs - Modules: ECMAScript modules