Intlayer 명령어 정의되지 않음
개요
Intlayer CLI는 사전 구축, 번역 푸시 등 intlayer 콘텐츠를 편리하게 제어할 수 있는 방법을 제공합니다. 그러나 프로젝트가 작동하는 데 필수적인 것은 아닙니다. 만약 Next.js용 withIntlayer()나 Vite용 intlayer()과 같은 번들러 플러그인을 사용하고 있다면, Intlayer는 앱 빌드 또는 개발 서버 시작 시 자동으로 사전을 빌드합니다. 개발 모드에서는 변경 사항을 감지하여 콘텐츠 선언 파일을 자동으로 재빌드하기도 합니다.
intlayer 명령어에 접근하는 방법은 다음과 같습니다:
- intlayer CLI 명령어를 직접 사용하는 방법
- VSCode 확장 사용
- @intlayer/cli SDK 사용
문제점
intlayer 명령어를 사용하려고 할 때 다음과 같은 오류가 발생할 수 있습니다:
'intlayer'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램 또는 배치 파일로 인식되지 않습니다.해결 방법
다음 해결 방법을 순서대로 시도해 보세요:
- 명령어가 설치되어 있는지 확인
npx intlayer -h예상 출력:
Usage: intlayer [options] [command]Intlayer CLIOptions: -V, --version 버전 번호 출력 -h, --help 명령어 도움말 표시Commands: dictionary|dictionaries 사전 관련 작업 configuration|config 설정 관련 작업 help [command] 명령어 도움말 표시- intlayer-cli 패키지를 전역으로 설치
npm install intlayer-cli -g -g이미 intlayer 패키지를 설치한 경우에는 필요하지 않을 수 있습니다.
- 패키지를 전역으로 설치
npm install intlayer -g터미널 재시작 새로운 명령어를 인식하려면 터미널을 재시작해야 할 때가 있습니다.
정리 후 재설치 위의 방법들이 효과가 없으면 다음을 시도하세요:
rm -rf node_modules package-lock.jsonnpm install설치 파일 확인 문제가 계속되면 다음 파일들이 존재하는지 확인하세요:
- node_modules/intlayer/dist/cjs/cli.cjs
- node_modules/intlayer/package.json (bin 필드가 ./dist/cjs/cli.cjs를 참조해야 함)
PATH 환경 변수 확인 npm 전역 bin 디렉토리가 PATH에 포함되어 있는지 확인하세요:
# Unix 기반 시스템(macOS/Linux)의 경우echo $PATH# /usr/local/bin 또는 ~/.npm-global/bin과 같은 경로가 포함되어야 합니다# Windows의 경우echo %PATH%# npm 글로벌 bin 디렉토리가 포함되어야 합니다- 전체 경로를 사용하여 npx 실행 명령어가 여전히 인식되지 않는 경우, 전체 경로를 사용하여 npx를 실행해 보세요:
npx ./node_modules/intlayer/ dictionaries build- 충돌하는 설치 확인
# 전역에 설치된 모든 패키지 목록 확인npm list -g --depth=0# 충돌하는 전역 설치 제거npm uninstall -g intlayernpm uninstall -g intlayer-cli# 그런 다음 재설치npm install -g intlayer- Node.js 및 npm 버전 확인 호환 가능한 버전을 사용하고 있는지 확인하세요:
node --versionnpm --version구버전을 사용 중이라면 Node.js와 npm을 업데이트하는 것을 고려하세요.- 권한 문제 확인하기
권한 오류가 발생하는 경우:
# 유닉스 기반 시스템용sudo npm install -g intlayer# 또는 npm 기본 디렉토리 변경mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'# ~/.profile 또는 ~/.bashrc에 다음을 추가하세요:export PATH=~/.npm-global/bin:$PATH