막혔을 때 확인할 것

작업이 멈췄다면 지금 보이는 증상부터 고르세요. 같은 요청을 반복하거나 전체를 다시 만들기 전에, 아래 순서로 어디까지 되는지 확인합니다.

화면이 안 나올 때

1. 대화의 답변 글과 결과물 카드를 구분합니다. 카드가 있다면 열어 봅니다.
2. 결과물 패널에 Preview 또는 미리보기 전환이 있는지 확인합니다.
3. 결과물 없이 코드만 있다면 실행 가능한 미리보기로 열어 달라고 요청합니다. 기능을 지원하지 않거나 사용량 제한이 있다면 표시된 안내를 읽습니다.

다음에 볼 곳: 시작 안내의 화면별 대처, 8장 · 도구를 고르는 기준과 서비스별 역할

수정한 내용이 안 보일 때

1. 바꾸기로 한 문장이나 요소 하나를 정하고 현재 화면과 비교합니다.
2. 최신 결과물을 열었는지 확인합니다. 미리보기와 내려받은 파일은 서로 다른 시점의 결과일 수 있습니다.
3. 공개한 사이트라면 수정 파일의 저장소 반영, 새 배포 완료, 현재 열어 둔 주소를 차례로 봅니다. 이전 배포의 고유 주소에서는 새 내용이 보이지 않을 수 있습니다.

다음에 볼 곳: 13장 · 대화창·코드·미리보기의 관계, 30장 · 공개한 페이지의 수정과 문제 해결

링크가 안 열릴 때

1. 링크에 표시된 글과 실제 이동할 주소를 나누어 확인합니다. 내가 준 주소와 같은지 봅니다.
2. 미리보기 안에서만 이동이 막히는지, 그 주소를 다른 탭에서 직접 열어도 안 되는지 구분합니다.
3. 공개 주소가 있다면 그곳에서 다시 누릅니다. 직접 이동을 시험하지 못했다면 완료로 표시하지 않고 보류합니다.

다음에 볼 곳: 21장 · 읽기와 링크 동작 확인하기, 29장 · 휴대전화와 실제 동작 확인하기

공개 주소가 안 열릴 때

1. Vercel 관리 화면 주소와 방문자용 사이트 주소를 구분합니다. 현재 프로젝트에 연결된 주소인지 확인합니다.
2. 배포가 처리 중인지, 실패했는지, 완료됐는지 읽습니다. 실패했다면 오류 안내와 파일 위치, 설정을 확인합니다.
3. 로그인 화면이 나오면 주소와 Deployment Protection 설정을 확인합니다. 의도한 공개 범위를 정한 뒤 접근 방식을 살핍니다. 누구에게 보여 줄지 결정하지 않은 채 보호 설정부터 해제하지 않습니다.

다음에 볼 곳: 28장 · GitHub의 파일 보관과 Vercel의 사이트 공개, 29장 · 내 페이지의 공개와 접속 확인

해결되지 않으면 AI에게 보내기

확인한 사실을 아래 양식에 적습니다. 모르는 항목은 ‘모름’, 안내가 없으면 ‘표시 없음’이라고 쓰세요. 오류 문장과 화면을 전달하기 전에 비밀번호, 비밀키, 다른 사람의 개인정보를 가립니다.

하려던 일: [목표]
사용한 도구와 환경: [도구·브라우저·기기]
문제가 생긴 곳: [미리보기·내려받은 파일·공개 사이트 중 어디인지]
내가 한 순서:
1. [한 행동]
2. [다음 행동]
3. [문제가 나타난 행동]
기대 결과: [어떻게 되길 바랐는지]
실제 결과: [직접 본 내용]
오류 안내: [민감한 값을 제외한 정확한 문장]
직전에 바꾼 것: [아는 범위]
이미 확인한 것과 결과: [위 순서에서 해 본 일]

위 내용을 바탕으로 먼저 확인할 순서를 설명해 줘.
원인 추측과 확인한 사실을 구분해 줘.
필요한 자료가 없으면 물어봐 줘.
전체 재작성, 자료 삭제, 다른 서비스 연결부터 진행하지 마.
수정이 필요하면 바꿀 부분과 유지할 부분을 먼저 알려 줘.

답변을 받은 뒤

제시된 확인을 하나씩 해 보고 결과를 기록합니다. 수정했다면 문제가 생겼던 행동을 다시 해 봅니다. 확인하지 못한 항목은 남겨 두고, 다른 부분이 잘 작동한다는 이유로 해결됐다고 표시하지 않습니다.

문제가 가끔만 생겨도 당시 기기와 주소, 직전에 한 행동을 적어 두면 도움이 됩니다. 더 자세한 설명은 15장 · 결과 확인과 막혔을 때의 대처에서 볼 수 있습니다.

꼭 기억하세요

‘안 돼요’에서 한 걸음 더 나아가, 무엇을 했고 무엇이 보였는지 남깁니다. 그 기록이 다음에 확인할 곳을 좁혀 줍니다.