Node.js 공식 릴리스 표에는 v24가 LTS, v26이 Current로 표시됩니다 (공식 릴리스 상태). Node.js 24 맥 설치가 처음이라면 공식 다운로드 경로로 설치한 뒤, 터미널에서 Node.js와 npm 버전을 확인하고 작은 자바스크립트 파일을 실행하세요. 수업에서 다른 버전을 지정했다면 새 버전으로 바꾸지 말고 수업 요구사항을 먼저 따르세요.
이 글은 맥에서 처음 자바스크립트를 배우며 Node.js를 설치하려는 학생을 위한 안내입니다.
학교에서 관리하는 컴퓨터를 쓰거나, 설치는 했는데 명령어가 작동하지 않는 경우에도 해당하는 부분부터 확인할 수 있습니다.
VS Code로 첫 과제를 실행하려는 초보자도 따라 할 수 있습니다.
SECTION 01설치 전에 수업 버전과 맥을 확인하세요
Node.js는 자바스크립트 프로그램을 실행하는 환경입니다. npm은 프로젝트에 필요한 추가 도구를 설치하고 관리하는 도구입니다. 쉽게 말해 Node.js는 과제를 실제로 실행하는 실습실이고, npm은 과제에 필요한 준비물을 챙기는 역할입니다. npm의 역할은 공식 안내에서 확인할 수 있습니다.
설치를 시작하기 전에 강의 안내와 프로젝트 파일을 살펴보세요. 강의에서 특정 Node.js 버전을 요구하거나 프로젝트에 버전 조건이 적혀 있다면 그 조건이 우선입니다. 더 최신 버전을 설치하면 저절로 과제가 더 잘 실행되는 것은 아닙니다. 과제 검증 결과가 달라질 수 있으므로, 버전을 바꾸기 전에는 강의 자료나 담당자에게 확인하세요.
맥이 어떤 종류인지도 확인합니다. Node.js 다운로드 페이지에서 사용하는 맥에 맞는 설치 항목을 선택하세요. 공식 페이지는 맥용 다운로드를 제공하며, 선택 가능한 설치 파일은 Node.js 다운로드 페이지에서 확인할 수 있습니다. 수업에서 권장하는 방식이 따로 없다면 공식 페이지의 설치 안내를 따르는 것이 안전합니다.
SECTION 02내 상황에 맞는 설치 경로를 선택하세요
| 선택지 | 적합한 상황 | 먼저 확인할 점 |
|---|---|---|
| Node.js 24 LTS 설치 | 버전 요구가 없는 입문 수업이나 새 연습 프로젝트 | 공식 페이지에서 맥에 맞는 설치 항목을 선택합니다. |
| 수업 지정 버전 유지 | 기존 프로젝트나 강의 안내에 버전 조건이 있는 경우 | 현재 버전을 먼저 확인하고, 임의로 교체하지 않습니다. |
| 학교 제공 환경 사용 | 관리 컴퓨터에서 설치가 제한된 경우 | 학교 규정과 과제에서 허용하는 환경을 확인합니다. |
| 원격 맥에서 실습 | 수업에 맥 환경이 필요하지만 현재 컴퓨터에서 설치할 수 없는 경우 | 원격 연결, 파일 위치, 실행 중인 터미널이 같은 환경인지 확인합니다. |
v24를 입문 경로로 고려할 수 있는 이유는 공식 릴리스 표에서 LTS로 표시되기 때문입니다. 다만 LTS라는 이유만으로 수업의 버전 요구를 무시해서는 안 됩니다. Node.js는 릴리스 단계에 따라 지원 상태가 달라질 수 있으니 설치 시점의 공식 릴리스 목록을 확인하세요. npm은 Node.js와 별도로 버전이 표시될 수 있으므로, 둘의 출력값을 같은 숫자로 맞춰야 한다고 생각하지 않아도 됩니다. npm 버전 안내도 참고할 수 있습니다.
SECTION 03공식 안내에 따라 설치하고 결과를 확인하세요
먼저 Node.js 공식 다운로드 페이지를 엽니다. 맥에 해당하는 설치 안내를 선택하고, 화면에 표시되는 단계를 따릅니다. 학교에서 관리하는 맥에서 설치 권한을 요청하거나 보호 설정을 변경하라는 메시지가 나오면 임의로 우회하지 말고 관리자나 수업 담당자에게 확인하세요.
설치가 끝나면 터미널을 엽니다. 터미널은 컴퓨터에 명령을 입력하는 창입니다. 아래 명령을 각각 실행합니다.
node --versionnpm --version
첫 번째 명령은 Node.js 버전을, 두 번째 명령은 npm 버전을 확인합니다. 출력이 보이면 해당 명령을 터미널이 찾은 것입니다. Node.js 버전이 수업 요구와 맞는지도 함께 비교하세요. 버전 출력이 없거나 오류가 나타나면 바로 설정 파일을 수정하지 말고 다음 문제 해결 항목으로 넘어갑니다.
이어서 hello.js라는 파일을 만들고 다음 한 줄을 저장합니다.
console.log('안녕하세요, 자바스크립트!');
터미널에서 파일이 저장된 폴더로 이동한 뒤 node hello.js를 실행합니다. 화면에 문장이 출력되면 Node.js가 파일을 실행한 것입니다. 이 방식은 Node.js 공식 실행 예시와 같은 기본 흐름입니다 (공식 실행 예시). 파일이 없다는 오류가 나오면 Node.js 설치보다 먼저 터미널이 파일이 있는 폴더를 가리키는지 확인하세요.
SECTION 04학교 맥과 기존 프로젝트는 권한부터 확인하세요
학교 컴퓨터에서 설치가 막혀 있다면 관리 정책에 따른 제한일 수 있습니다. 관리자 권한을 얻으려 하거나 보호 설정을 바꾸지 마세요. 학교에서 승인한 개발 환경, 수업에서 허용한 브라우저 실습, 또는 담당자가 안내한 원격 환경을 선택해야 합니다. 브라우저 도구가 파일 실행이나 제출 방식까지 지원하는지는 과제 안내에서 확인하세요.
원격 맥으로 실습할 때는 작업 파일을 원격 컴퓨터에 두었는지 확인합니다. 내 노트북의 파일을 열어 놓고 원격 맥 터미널에서 명령을 입력하면, 두 프로그램이 서로 다른 파일을 보고 있을 수 있습니다. 연결한 컴퓨터에서 프로젝트 폴더를 열고 그 폴더의 터미널로 실행하는 것이 핵심입니다. 원격 맥 환경이 필요하다면 맥 학습 환경 안내를 살펴보고, 수업에서 허용하는 사용 방식인지 먼저 확인하세요.
이미 프로젝트가 있는데 node 또는 npm을 찾지 못한다면, 오류 메시지를 그대로 확인한 뒤 다음 순서로 점검합니다.
node --version과npm --version을 각각 실행합니다. 한 명령만 실패한다면 두 도구를 같은 것으로 간주하지 말고 실패한 명령을 따로 확인합니다.- 설치를 마친 뒤에도 명령을 찾지 못하면 터미널을 완전히 닫고 새 터미널을 엽니다. 이전 창이 설치 전 환경을 계속 사용하고 있을 수 있습니다.
command -v node를 실행해 현재 터미널이node명령을 찾는지 확인합니다. 아무 경로도 반환하지 않으면 명령을 찾지 못한 상태입니다.- 설치 경로나 셸 설정을 임의로 편집하지 않습니다. 공식 다운로드 안내를 다시 확인하고, 관리 기기라면 학교 지원 담당자에게 문의합니다.
node가 실행되지만 과제가 실패하는 경우는 설치 문제만이 아닐 수 있습니다. 프로젝트 폴더에서 명령을 실행했는지, 수업에서 지정한 버전이 있는지, 오류가 어떤 파일을 가리키는지 확인하세요. npm의 사용 목적은 패키지 관리이며, 설치된 npm 자체의 버전은 npm --version으로 확인할 수 있습니다 (npm 공식 안내).
SECTION 05VS Code에서 첫 파일을 실행하세요
VS Code는 코드를 작성하고 파일을 관리하는 편집기입니다. Node.js는 그 코드를 실행하는 환경이므로, 편집기를 설치했다고 Node.js까지 준비된 것은 아닙니다. 맥용 설치 절차는 VS Code 공식 안내에서 확인하고, 추가 구성요소의 역할은 공식 구성요소 문서에서 살펴보세요.
VS Code에서 hello.js가 들어 있는 폴더를 엽니다. 편집기에서 파일을 저장한 다음, 터미널 메뉴에서 터미널을 엽니다. 터미널 위치가 현재 프로젝트 폴더인지 확인하고 node hello.js를 실행하세요. 파일을 편집한 창과 명령을 실행하는 터미널이 서로 다른 폴더를 가리키면 저장한 내용과 실행 결과가 어긋날 수 있습니다.
터미널에 예상한 문장이 나오면 첫 실행 확인은 끝입니다. 출력이 다르다면 파일이 저장됐는지, 파일 이름이 hello.js인지, 실행 명령 뒤의 이름이 실제 파일과 일치하는지 확인하세요. 여기까지 확인되면 문법을 더 배우기 전에 수업 프로젝트의 안내에 맞춰 다음 과제를 진행하면 됩니다.
SECTION 06자주 묻는 질문
맥에서 Node.js와 npm 설치 여부는 어떻게 확인하나요?
터미널에서 node --version과 npm --version을 각각 실행하세요. 각각 버전 정보가 표시되면 두 명령을 사용할 수 있는 상태입니다. 다만 출력이 있다는 것만으로 강의 프로젝트에 맞는 버전이라는 뜻은 아닙니다. 강의 안내와 프로젝트 조건을 따로 확인하세요. 명령 중 하나가 실패하면 다른 명령의 결과와 섞지 말고 실패한 쪽부터 점검합니다.
설치했는데 터미널에서 node를 찾지 못하면 어떻게 하나요?
설치가 완료됐는지 확인한 다음, 기존 터미널을 닫고 새 창을 열어 다시 확인하세요. 이어서 command -v node를 실행하면 현재 터미널에서 명령을 찾는지 알 수 있습니다. 경로가 나오지 않으면 설치 또는 환경 인식에 문제가 있을 수 있습니다. 학교 관리 맥에서는 셸 설정이나 보호된 경로를 직접 수정하지 말고 관리자에게 문의하세요.
학교 컴퓨터에 설치할 수 없을 때는 어떻게 과제를 실행하나요?
학교에서 제공하는 환경이나 수업에서 승인한 브라우저 실습이 있는지 먼저 확인하세요. 그 방법으로 과제의 실행과 제출이 가능한지는 강의 안내를 기준으로 판단해야 합니다. 설치 제한을 우회하거나 승인되지 않은 권한 변경을 시도하지 마세요. 허가된 원격 맥을 이용한다면 파일과 터미널이 모두 원격 컴퓨터에 연결돼 있는지 확인한 뒤 실행하세요.
VS Code에서 첫 자바스크립트 파일이 실행되지 않으면 무엇을 확인하나요?
먼저 Node.js가 준비됐는지 node --version으로 확인합니다. 그다음 VS Code가 프로젝트 폴더를 열었는지, hello.js를 저장했는지, 터미널도 같은 폴더를 보고 있는지 살펴보세요. node hello.js 실행 결과가 보이면 기본 환경은 작동합니다. 편집기 설치와 Node.js 설치는 별개이므로 한쪽만 준비돼 있지 않은지도 확인해야 합니다.
Node.js만 배우는 수업이라면 기존 컴퓨터에서 실행해도 충분할 수 있습니다. 반면 과제에 맥 전용 도구가 포함돼 있거나 학교 컴퓨터의 설치 제한 때문에 실습을 이어가기 어렵다면, 현재 환경에는 권한 제약과 파일 이동 번거로움, 수업 환경과 다른 설정이라는 불편이 생길 수 있습니다. 이 경우에는 필요한 기간만 원격 맥을 사용하는 방법을 검토할 수 있습니다. 장기적으로 매일 무거운 작업을 하거나 직접 연결해야 하는 기기가 있다면 실물 맥이 더 적합할 수 있으니, 요금 안내에서 이용 조건을 비교한 뒤 수업에 필요한 경우에만 MACNOX 원격 맥 이용 안내를 확인하세요.
SECTION 07자주 묻는 질문 FAQ
맥에서 Node.js와 npm이 설치됐는지 어떻게 확인하나요?
터미널을 열고 node --version을 입력하면 현재 Node.js 버전이 표시됩니다. 이어서 npm --version을 실행해 npm 버전도 확인하세요. 두 명령 모두 버전 문자열을 반환하면 명령을 찾은 것입니다. 다만 설치 여부와 수업 프로젝트가 요구하는 버전은 별개이므로, 수업 안내와 package.json의 조건도 함께 확인해야 합니다.
Node.js 24를 설치했는데 터미널에서 node 명령을 찾지 못하면 어떻게 하나요?
먼저 설치 프로그램이 완료됐는지 확인하고, 설치 전부터 열려 있던 터미널 창을 닫은 뒤 새로 열어 node --version을 실행하세요. 여전히 명령을 찾지 못하면 command -v node로 현재 셸이 명령을 찾는지 확인합니다. 설치 위치나 셸 설정을 임의로 바꾸기보다 공식 설치 안내를 다시 확인하고, 학교 관리 기기라면 담당자에게 문의하세요.
학교 컴퓨터에 프로그램을 설치할 수 없어도 Node.js 과제를 할 수 있나요?
학교 규정이 허용한다면 학교에서 제공하는 개발 환경이나 브라우저 기반 실습 도구를 먼저 이용할 수 있습니다. 로컬 설치가 필요하고 권한이 없다면 보호 설정을 우회하거나 관리 권한을 바꾸지 마세요. 수업 담당자에게 허용된 환경을 확인하고, 원격 맥을 쓸 때는 파일과 터미널이 같은 원격 컴퓨터에 연결됐는지 점검해야 합니다.
Node.js 24를 설치한 뒤 VS Code에서 첫 자바스크립트 파일을 어떻게 실행하나요?
VS Code에서 작업 폴더를 열고 hello.js 파일에 console.log('안녕하세요');를 입력해 저장합니다. VS Code의 터미널에서 현재 위치가 그 작업 폴더인지 확인한 다음 node hello.js를 실행하세요. 터미널에 문장이 보이면 파일 실행이 된 것입니다. 편집기는 파일을 작성하고 Node.js는 그 파일을 실행하므로, 두 프로그램이 각각 준비돼 있어야 합니다.