--env-file + --watch — 내장 개발 기능

"Node의 내장 플래그만으로 dotenv와 nodemon이 하던 흔한 일을 대신할 수 있어. 범위가 더 좁으니, 프로젝트가 그 범위 안에 있을 때만 가볍게 가져가면 돼."

--env-file은 환경 변수를 읽어 줘

dotenv가 하는 핵심 일은 .env 파일을 읽어 값을 process.env에 넣는 거야. Node 20부터는 런타임이 이 기능을 직접 제공해.

# .env
DATABASE_URL=postgres://localhost/mydb
LOG_LEVEL=debug
API_KEY=sk-something-secret

node --env-file=.env script.mjs
# script.mjs 안에서 process.env.DATABASE_URL을 읽을 수 있어

파일을 여러 개 지정하면 앞에서 읽은 값을 뒤 파일이 덮을 수 있어. 공통 설정과 로컬 설정을 나눌 때 유용하지.

node --env-file=.env --env-file=.env.local server.mjs
# 같은 key가 있으면 .env.local의 값이 적용돼

형식은 익숙한 dotenv 관례를 따라. 한 줄에 KEY=value를 쓰고, 주석은 #로 시작하며, 공백이 든 값은 따옴표로 감싸면 돼. 이 정도가 필요의 전부라면 별도 패키지를 둘 이유가 없어.

--watch는 파일이 바뀌면 프로세스를 다시 띄워

nodemon의 흔한 용도는 프로젝트 파일을 지켜보다 변경이 생기면 Node 프로세스를 다시 시작하는 거야. Node 22에서는 --watch가 안정 기능이 됐어.

node --watch server.mjs
# server.mjs나 불러온 module을 저장하면 process가 다시 시작돼

기본 watch mode는 entry file에서 module graph를 따라가며 불러온 파일을 감시해. 깊숙한 utility를 고쳐도 다시 시작되는 이유야. 감시할 위치를 직접 정해야 한다면 --watch-path=./config를 쓸 수 있어. 다만 이 옵션은 기본 module graph 감시를 대체하고 macOS와 Windows에서만 지원돼.

단순한 개발 서버라면 한 줄이면 돼

node --env-file=.env --watch server.mjs

어떤 env 파일을 읽을지는 application 정책이야

Next.js나 Vite 같은 frontend framework는 .env, .env.local, .env.production을 정해진 순서로 알아서 읽어. Node의 --env-file은 그런 우선순위를 대신 정하지 않아. 필요한 순서를 command에 직접 적어야 해.

# 개발 환경
node --env-file=.env --env-file=.env.local server.mjs

# 운영 환경 — CI가 이 command를 선택
node --env-file=.env --env-file=.env.production server.mjs

환경이 여러 개라면 NODE_ENV를 보고 알맞은 조합을 고르는 작은 wrapper를 둘 수 있어. 플래그는 파일을 읽을 뿐 어떤 정책이 옳은지 결정하지 않아. 그래서 예상 밖의 자동 동작이 없다는 장점이 있고, 선택은 application이 책임져야 한다는 한계도 있어.

--watch는 HMR이 아니야

--watch는 변경이 생기면 프로세스를 통째로 다시 시작해. 실행 중인 module export만 바꾸는 Hot Module Replacement는 제공하지 않아. Frontend 개발 서버에서는 화면 상태를 살리는 HMR이 유용하지만, backend에서는 깨끗한 process 재시작이 오히려 안전한 경우가 많아. 오래된 subscription이나 중복 listener 같은 이전 상태를 남기지 않으니까.

Pippa의 고백