시코딩 몰라도 PowerShell 오류 두 번 뚫고 미리보기 띄운 날

소개

시코딩 몰라도 PowerShell 오류 두 번 뚫고 미리보기 띄운 날

npm 실행이 막히는 오류와 node_modules가 깨지는 오류를 순서대로 해결하고 로컬 미리보기를 띄운 기록

한 줄 요약

코딩을 전혀 모르는 내가, 학습허브 사이트 미리보기를 띄우다가 Windows 보안 정책 오류와 설치 깨짐 오류를 연달아 만났다. 둘 다 AI가 알려준 명령어 한 줄씩으로 풀었다.

이런 분들께 도움돼요

• Windows에서 npm 명령을 처음 써보는 비개발자

• npm : 이 시스템에서 스크립트를 실행할 수 없으므로... 오류를 만난 분

• Cannot find module 같은 오류로 미리보기가 안 뜨는 분

Before — 뭐가 문제였나

템플릿을 설치하고 학습메이트까지 만든 뒤, “이제 내 사이트를 미리보기로 띄워줘”라고 했다. PowerShell 창을 열어서 npm install, npm run dev를 입력했는데 바로 막혔다.

npm : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Program Files\nodejs\npm.ps1 파일을 로드할 수 없습니다.
복사

어떻게 — 막힘과 해결

막힘 1: PowerShell 실행 정책

Windows가 보안상 기본적으로 스크립트 실행을 막아둔 상태였다. 아래 명령 한 줄로 지금 계정에서만 정책을 풀었다.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
복사

물어보면 Y를 입력하고 엔터. 그 다음 npm install, npm run dev를 다시 실행하면 된다.

막힘 2: 설치가 중간에 깨짐

정책은 풀렸는데, 이번엔 npm run dev에서 다른 오류가 났다.

Error [ERR_MODULE_NOT_FOUND]: Cannot find module '...\node_modules\shiki\dist\index.mjs'
복사

설치(npm install)가 중간에 뭔가 문제가 있어서 일부 파일이 덜 깔린 상태였다. 지우고 다시 까는 걸로 해결했다.

Remove-Item -Recurse -Force node_modules; npm install; npm run dev
복사

After — 결과

astro v4.16.19 ready in 381 ms
┃ Local    http://localhost:4321/
복사

이 주소를 브라우저에 붙여넣으니 내 사이트 첫 화면이 떴다.

느낀 점

오류 메시지만 보면 겁부터 났는데, 막상 원인은 둘 다 “명령어 한 줄”로 풀리는 문제였다. 처음엔 답답했지만, 오류 메시지를 그대로 복사해서 물어보기만 하면 되는구나 싶었다.

재사용 자산 — 막히면 이 순서로

1. npm : 이 시스템에서 스크립트를 실행할 수 없으므로... 오류 → Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned 실행 후 Y

2. Cannot find module ... 오류로 미리보기가 안 뜨면 → Remove-Item -Recurse -Force node_modules; npm install 로 재설치

3. 오류 메시지는 지레짐작하지 말고 화면에 뜬 그대로 복사해서 AI에게 붙여넣기. 원인 진단이 훨씬 빠르다.도하고자 했던 것과 그 이유를 알려주세요.

(내용 입력)

진행 방법

어떤 도구를 사용했고, 어떻게 활용하셨나요?

Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.

Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.

Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)

(내용 입력)

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

과정 중에 어떤 시행착오를 겪었나요?

도움이 필요한 부분이 있나요?

앞으로의 계획이 있다면 들려주세요.

(내용 입력)

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

(내용 입력)