React보다 더 강력한 웹 프레임워크를 찾고 있다면 Next.js가 제격입니다.
이번 글에서는 Windows 환경에서 Next.js 개발을 시작하기 위한 세팅 방법을 처음부터 끝까지 정리해 볼게요.
처음 접하는 분들도 따라오기 쉽게 단계별로 설명했습니다.
📦 1. Node.js 설치하기
Next.js는 Node.js 위에서 돌아가므로 먼저 Node.js부터 설치해야 해요.
- Node.js 공식 사이트 접속
- LTS (권장 버전) 다운로드 후 설치
- 설치 중에는 기본 설정 그대로 진행하면 됩니다.
- 터미널에서 설치 확인
node -v
npm -v
🛠️ 2. PowerShell 실행 정책 설정
간혹 PowerShell에서 npx 명령이 작동하지 않거나 권한 문제가 발생할 수 있어요.
이때는 아래 명령어로 실행 정책을 RemoteSigned로 설정해 주면 대부분 해결됩니다.
▶ PowerShell에서 입력:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- "변경하시겠습니까?"라는 질문이 나오면 Y 입력 후 Enter
- 이 설정은 인터넷에서 받은 스크립트는 서명된 것만 실행, 로컬은 무제한 허용이라는 의미예요
▶ 적용 확인:
Get-ExecutionPolicy -List
- CurrentUser 항목이 RemoteSigned로 되어 있으면 OK!
🚀 3. Next.js 프로젝트 만들기
이제 진짜 프로젝트를 생성해 볼게요!
▶ 명령어 입력 (PowerShell 또는 CMD):
npx create-next-app my-next-app
- my-next-app는 프로젝트 이름으로 자유롭게 바꿔도 돼요
- 처음 실행 시 약간 시간이 걸릴 수 있어요
▶ 폴더 이동 후 개발 서버 실행
cd my-next-app
npm run dev
브라우저에서 http://localhost:3000으로 접속하면
Next.js 기본 페이지가 짠!
⚠️ 에러가 난다면?
간혹 npm, npx 관련 오류가 발생하면 아래 체크리스트를 확인해 보세요:
- Node.js 설치 확인: node -v, npm -v
- PowerShell 실행 정책: RemoteSigned로 설정했는가?
- PowerShell은 관리자 권한으로 실행했는가?
- CMD로 시도해도 같은 문제가 나는가?
✅ 마무리
이제 여러분도 Windows 환경에서 Next.js 개발을 시작할 준비가 완료됐습니다.
이 환경만 세팅해 두면, 앞으로 블로그, 포트폴리오, 쇼핑몰까지 만들 수 있어요!