이번 소식
Cloudflare가 2026년 10월 23일 Workers Builds에서 프로젝트의 package.json 파일에 지정한 npm 버전을 사용할 수 있다고 발표했습니다. npm은 앱에 필요한 패키지를 설치할 때 사용하는 도구입니다. 이번 변경은 사이트 방문자가 아니라 Workers Builds로 앱을 빌드·배포하는 개발팀에 해당합니다.
달라진 점
packageManager 항목에 원하는 npm 버전을 적으면, 빌드에서 의존 패키지를 설치하기 전에 그 npm 버전을 먼저 설치합니다. 공식 예시는 npm@11.19.1입니다. 새로운 npm으로 작성한 잠금 파일을 원격 빌드에서도 로컬과 같은 방식으로 처리할 수 있도록 한 변경입니다.
어떤 점이 달라지나요?
개발자의 컴퓨터와 Cloudflare 빌드에서 사용하는 npm 버전을 맞추려면 프로젝트 설정에 정확한 버전을 명시할 수 있습니다. 버전을 범위로 지정하는 방식은 지원하지 않으며, engines.npm 항목은 Workers Builds가 npm 버전을 고르는 데 사용하지 않습니다.
이전 발표와 달라진 점
10월 14일 기본 도구 버전 변경 소식은 버전을 별도로 지정하지 않은 빌드의 기본값을 다뤘습니다. 이번 발표는 npm 버전을 packageManager로 직접 선택하는 기능에 관한 별도 변경입니다.
사용 전 확인할 점
같은 항목으로 Yarn·pnpm·Bun의 버전도 지정할 수 있습니다. 예시의 11.19.1을 모든 프로젝트가 반드시 사용해야 한다거나 npm 전체의 최신 버전이라는 뜻으로 받아들이면 안 됩니다. 프로젝트에 맞는 정확한 버전을 지정하는 것이 핵심입니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.
