자주 묻는 질문

강의를 따라 하다 자주 막히는 부분을 정리했습니다.

강의 일반

이 강의는 누구를 위한 강의인가요?

HTML 과 CSS 를 조금 다뤄 본 분이라면 누구나 들을 수 있습니다. React, Vue 같은 프레임워크 경험은 필요하지 않습니다. 자바스크립트를 전혀 모른다면 변수와 함수 정도의 기초만 익히고 시작하면 훨씬 수월합니다.

강의는 무료인가요? 회원가입이 필요한가요?

모든 강의는 무료이며 회원가입 없이 바로 볼 수 있습니다. 새 강의가 올라오면 RSS 로 구독하실 수 있습니다.

강의는 순서대로 들어야 하나요?

네, 1강부터 순서대로 듣는 것을 권합니다. 각 강의는 이전 강의에서 만든 프로젝트를 이어서 발전시키는 구성이라, 중간부터 시작하면 앞에서 만든 파일이 없어 따라 하기 어렵습니다. Astro 를 이미 어느 정도 안다면 4강(콘텐츠 컬렉션)이나 5강(SEO·배포)만 골라 보셔도 됩니다.

환경 설정

Node.js 는 어떤 버전을 설치해야 하나요?

nodejs.org 의 LTS 버전을 설치하면 됩니다. 이미 설치되어 있다면 터미널에서 node -v 로 버전을 확인하세요. 버전이 18 미만이면 최신 LTS 로 업데이트해야 Astro 가 정상 동작합니다.

npm run dev 를 실행했는데 오류가 나요.

가장 흔한 원인 세 가지를 순서대로 확인해 보세요.

  1. 프로젝트 폴더 안에서 실행했는지 — package.json 이 있는 폴더에서 실행해야 합니다.
  2. 패키지 설치 여부 — node_modules 폴더가 없다면 npm install 을 먼저 실행하세요.
  3. 포트 충돌 — 4321 포트를 다른 프로그램이 쓰고 있으면 Astro 가 자동으로 다른 포트를 고릅니다. 터미널에 표시된 주소를 확인하세요.

그래도 해결되지 않으면 오류 메시지 전체를 검색해 보세요. 대부분 같은 문제를 겪은 사례가 있습니다.

SEO·배포

배포했는데 구글·네이버에서 검색이 안 돼요.

배포 직후에는 검색되지 않는 것이 정상입니다. 5강의 순서대로 구글 서치 콘솔과 네이버 서치어드바이저에 사이트를 등록하고 사이트맵을 제출했는지 확인하세요. 등록 후 실제 검색 결과에 나오기까지 보통 며칠에서 몇 주가 걸립니다. 서치 콘솔의 “URL 검사 → 색인 생성 요청” 을 이용하면 조금 빨라집니다.

어디에 배포하는 것이 좋나요?

Astro 는 정적 파일을 만들기 때문에 Vercel, Netlify, Cloudflare Pages, GitHub Pages 등 어디든 무료로 배포할 수 있습니다. 처음이라면 GitHub 저장소를 연결하기만 하면 되는 Vercel 이나 Netlify 를 권합니다. 자세한 방법은 5강을 참고하세요.