Node.js 설치

웹사이트를 만들려면 하나 더 설치해야 할 것이 있습니다. 바로 Node.js입니다.

Node.js가 뭔가요?

Node.js는 웹사이트를 내 컴퓨터에서 실행해 볼 수 있게 해주는 엔진입니다.

비유하자면 이렇습니다:

자동차(웹사이트)가 달리려면 엔진(Node.js)이 필요합니다. 엔진 자체를 직접 만지거나 이해할 필요는 없어요. 그냥 설치만 해두면 알아서 작동합니다.

Node.js가 뭘 하는지 몰라도 전혀 괜찮습니다. "웹사이트를 돌리려면 필요한 거구나" 정도만 알면 됩니다.

다운로드

1. Chrome 브라우저를 엽니다
2. 주소창에 nodejs.org 를 입력하고 Enter를 누릅니다
3. 화면에 큰 초록색 버튼이 보입니다

버튼이 두 개 보일 수 있는데:

LTS는 "Long Term Support"의 줄임말로, "오래 검증된 안정 버전"이라는 뜻입니다. 항상 LTS를 선택하면 됩니다.

설치하기 (Windows)

설치는 정말 간단합니다. "Next" 버튼만 계속 누르면 됩니다.

1. 다운로드된 파일을 더블클릭합니다 (파일 이름은 node-v숫자-x64.msi 형태)
2. 설치 마법사가 열립니다
3. "Next" 클릭
4. 라이선스 동의 체크 → "Next" 클릭
5. 설치 경로 → 그대로 두고 "Next" 클릭
6. 기능 선택 → 그대로 두고 "Next" 클릭
7. "Install" 클릭
8. "이 앱이 디바이스를 변경할 수 있도록 허용하시겠습니까?" → "예"
9. 설치 완료 → "Finish" 클릭

중간에 어떤 옵션을 바꿔야 하는지 고민하지 마세요. 전부 기본값 그대로 두고 Next만 누르면 됩니다.

설치하기 (Mac)

1. 다운로드된 .pkg 파일을 더블클릭합니다
2. 마찬가지로 "계속"만 계속 클릭합니다
3. 설치 완료!

설치 확인하기

설치가 잘 되었는지 확인해 봅시다. Cursor를 열어주세요.

1. Cursor를 엽니다 (또는 이미 열려 있다면 그대로)
2. ` Ctrl + `` 를 눌러 터미널을 엽니다
3. 아래 명령을 입력하고 Enter를 누릅니다:

node --version

이런 결과가 나오면 성공입니다:

v22.13.0

숫자는 다를 수 있습니다. v로 시작하는 버전 번호가 나오기만 하면 됩니다!

하나 더 확인해 봅시다:

npm --version

이것도 숫자가 나오면 성공입니다. npm은 Node.js와 함께 자동으로 설치되는 도구인데, 나중에 필요한 부품을 설치할 때 사용합니다.

문제 해결: "node를 인식할 수 없습니다"

터미널에 node --version을 입력했는데 이런 메시지가 나오는 경우:

'node'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

이것은 Cursor를 Node.js 설치 전에 열었기 때문입니다. 해결 방법은 간단합니다:

1. Cursor를 완전히 닫습니다 (X 버튼)
2. Cursor를 다시 엽니다
3. 터미널에서 node --version을 다시 입력합니다

Cursor가 처음 열릴 때 컴퓨터에 설치된 프로그램 목록을 확인합니다. Node.js를 설치한 후에 Cursor를 다시 열어야 "아, Node.js가 있구나"라고 인식하는 거예요.

그래도 안 되면 컴퓨터를 재시작한 후 다시 시도해 보세요.

직접 해보기

1. nodejs.org 에서 LTS 버전을 다운로드합니다
2. Next만 눌러서 설치합니다
3. Cursor를 닫았다가 다시 엽니다
4. 터미널에서 node --version을 입력합니다
5. 버전 번호가 나오면 성공!

이 절의 요약

• Node.js는 웹사이트를 내 컴퓨터에서 실행하게 해주는 엔진입니다
• nodejs.org 에서 LTS 버전을 다운로드합니다
• 설치할 때는 Next만 계속 클릭하면 됩니다
• 설치 확인: 터미널에서 node --version 입력 → 버전 번호가 나오면 성공
• "인식할 수 없습니다" 오류 → Cursor를 껐다 다시 켜세요