Intlayer 명령어 정의되지 않음

    개요

    Intlayer CLI는 사전 구축, 번역 푸시 등 intlayer 콘텐츠를 편리하게 제어할 수 있는 방법을 제공합니다. 그러나 프로젝트가 작동하는 데 필수적인 것은 아닙니다. 만약 Next.js용 withIntlayer()나 Vite용 intlayer()과 같은 번들러 플러그인을 사용하고 있다면, Intlayer는 앱 빌드 또는 개발 서버 시작 시 자동으로 사전을 빌드합니다. 개발 모드에서는 변경 사항을 감지하여 콘텐츠 선언 파일을 자동으로 재빌드하기도 합니다.

    intlayer 명령어에 접근하는 방법은 다음과 같습니다:

    • intlayer CLI 명령어를 직접 사용하는 방법
    • VSCode 확장 사용
    • @intlayer/cli SDK 사용

    문제점

    intlayer 명령어를 사용하려고 할 때 다음과 같은 오류가 발생할 수 있습니다:

    bash
    'intlayer'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램 또는 배치 파일로 인식되지 않습니다.

    해결 방법

    다음 해결 방법을 순서대로 시도해 보세요:

    1. 명령어가 설치되어 있는지 확인
    bash
    npx intlayer -h

    예상 출력:

    bash
    Usage: intlayer [options] [command]

Intlayer CLI

Options:
    -V, --version            버전 번호 출력
    -h, --help               명령어 도움말 표시

Commands:
    dictionary|dictionaries  사전 관련 작업
    configuration|config     설정 관련 작업
    help [command]           명령어 도움말 표시
    1. intlayer-cli 패키지를 전역으로 설치
    bash
    npm install intlayer-cli -g -g
    이미 intlayer 패키지를 설치한 경우에는 필요하지 않을 수 있습니다.
    1. 패키지를 전역으로 설치
    bash
    npm install intlayer -g

    1. 터미널 재시작 새로운 명령어를 인식하려면 터미널을 재시작해야 할 때가 있습니다.

    2. 정리 후 재설치 위의 방법들이 효과가 없으면 다음을 시도하세요:

    bash
    rm -rf node_modules package-lock.json
npm install

    1. 설치 파일 확인 문제가 계속되면 다음 파일들이 존재하는지 확인하세요:

      • node_modules/intlayer/dist/cjs/cli.cjs
      • node_modules/intlayer/package.json (bin 필드가 ./dist/cjs/cli.cjs를 참조해야 함)

    2. PATH 환경 변수 확인 npm 전역 bin 디렉토리가 PATH에 포함되어 있는지 확인하세요:

    bash
    # Unix 기반 시스템(macOS/Linux)의 경우
echo $PATH
# /usr/local/bin 또는 ~/.npm-global/bin과 같은 경로가 포함되어야 합니다

# Windows의 경우
echo %PATH%
# npm 글로벌 bin 디렉토리가 포함되어야 합니다
    1. 전체 경로를 사용하여 npx 실행 명령어가 여전히 인식되지 않는 경우, 전체 경로를 사용하여 npx를 실행해 보세요:
    bash
    npx ./node_modules/intlayer/ dictionaries build
    1. 충돌하는 설치 확인
    bash
    # 전역에 설치된 모든 패키지 목록 확인
npm list -g --depth=0

# 충돌하는 전역 설치 제거
npm uninstall -g intlayer
npm uninstall -g intlayer-cli
# 그런 다음 재설치
npm install -g intlayer
    1. Node.js 및 npm 버전 확인 호환 가능한 버전을 사용하고 있는지 확인하세요:
    bash
    node --version
npm --version
    plaintext
    구버전을 사용 중이라면 Node.js와 npm을 업데이트하는 것을 고려하세요.
    1. 권한 문제 확인하기
      권한 오류가 발생하는 경우:
    bash
    # 유닉스 기반 시스템용
sudo npm install -g intlayer

# 또는 npm 기본 디렉토리 변경
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# ~/.profile 또는 ~/.bashrc에 다음을 추가하세요:
export PATH=~/.npm-global/bin:$PATH