·오류 문구 사전

shell · npm

오류 문구

zsh: command not found: tsc

무슨 뜻인가

셸이 PATH를 훑었지만 그 이름의 실행 파일을 찾지 못했다는 뜻입니다 — 설치 자체는 성공했을 수 있습니다. npm의 전역 bin 디렉터리가 PATH에 없거나, 전역이 아니라 로컬로 설치해서 실행 파일이 node_modules/.bin에 들어갔거나, 셸이 예전 PATH를 캐시에 물고 있을 때 나옵니다. npx tsc --version은 PATH를 손대지 않고 로컬 사본을 그대로 실행하므로, 설치가 되어 있는지 없는지를 그 한 줄로 갈라 줍니다. 정말로 전역에 설치한 것이라면 npm prefix -g의 출력 뒤에 /bin을 붙인 경로를 PATH에 더하고 셸을 새로 열면 됩니다.

고치는 명령

npx tsc --version
내는 도구
shell
npm
20

npm ERR!로 시작하는 줄은 대개 마지막 여섯 줄이 아니라 첫 code XXXX 한 줄에 원인이 적혀 있고, 오류가 내 코드가 아니라 의존성 나무나 네이티브 빌드에서 온 것이면 node_modules를 지우고 다시 설치하는 것으로 절반이 풀립니다.

오류 문구를 읽는 법

  • 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
  • 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
  • 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
  • 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
  • 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.

자주 묻는 질문

Q. zsh: command not found: tsc 는 무슨 뜻인가요?

셸이 PATH를 훑었지만 그 이름의 실행 파일을 찾지 못했다는 뜻입니다 — 설치 자체는 성공했을 수 있습니다. npm의 전역 bin 디렉터리가 PATH에 없거나, 전역이 아니라 로컬로 설치해서 실행 파일이 node_modules/.bin에 들어갔거나, 셸이 예전 PATH를 캐시에 물고 있을 때 나옵니다. npx tsc --version은 PATH를 손대지 않고 로컬 사본을 그대로 실행하므로, 설치가 되어 있는지 없는지를 그 한 줄로 갈라 줍니다. 정말로 전역에 설치한 것이라면 npm prefix -g의 출력 뒤에 /bin을 붙인 경로를 PATH에 더하고 셸을 새로 열면 됩니다.

Q. 어떻게 고치나요?

npx tsc --version — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.

Q. 어느 도구가 내는 오류인가요?

shell입니다. npm 갈래에 있고, 문구는 5낱말입니다.

같이 나는 오류