npm-*: add Korean translation (#22162)

This commit is contained in:
HoJeong Im
2026-04-27 23:39:40 +09:00
committed by GitHub
parent 95ede6070e
commit 3d4f407cb9
33 changed files with 688 additions and 0 deletions
+21
View File
@@ -0,0 +1,21 @@
# npm bugs
> 패키지의 버그를 웹 브라우저에서 보고할 수 있는 명령어.
> 패키지의 버그 트래커 URL 또는 지원 이메일을 자동으로 열기.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-bugs/>.
- 특정 패키지의 버그 트래커를 열어, 보고:
`npm bugs {{패키지_이름}}`
- `package.json` 파일 및 이름을 찾아 현재 패키지의 버그 트래커를 열기:
`npm bugs`
- `npm` 명령으로 URL을 열 때, 사용할 브라우저를 설정:
`npm {{[c|config]}} set browser {{브라우저_이름}}`
- URL 열기 방식 설정: `browser``true`로 설정하면 시스템 기본 URL 실행기를 사용하고, `false`로 설정하면 URL을 터미널에 출력:
`npm {{[c|config]}} set browser {{true|false}}`
+17
View File
@@ -0,0 +1,17 @@
# npm ci
> 자동와 환경에서 사용하는 `npm` 프로젝트 의존성의 클린 설치 명령어.
> `package-lock.json` 또는 `npm-shrinkwrap.json` 기준으로 패키지를 설치.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-ci/>.
- `package-lock.json` 또는 `npm-shrinkwrap.json`을 기반으로 의존성 설치:
`npm ci`
- 특정 유형의 의존성을 제외하고 설치:
`npm ci --omit {{dev|optional|peer}}`
- `package.json`에 정의된 pre/post 스크립트를 실행하지 않고 설치:
`npm ci --ignore-scripts`
+20
View File
@@ -0,0 +1,20 @@
# npm completion
> npm 명령어의 탭 자동완성을 활성화하거나 설정하는 도구.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-completion/>.
- 현재 쉘 세션에서 탭 자동완성 활성화:
`npm completion`
- Bash 프로파일에 자동완성 추가:
`npm completion >> ~/.bashrc`
- Zsh 프로파일에 자동완성 추가:
`npm completion >> ~/.zshrc`
- 자동완성 스크립트를 특정 파일로 저장:
`npm completion > {{경로/대상/파일}}`
+32
View File
@@ -0,0 +1,32 @@
# npm config
> `npm` 설정을 관리하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-config/>.
- 모든 설정 값 출력:
`npm {{[c|config]}} list`
- 모든 설정을 `JSON` 형식으로 출력:
`npm {{[c|config]}} list --json`
- 특정 설정 값 조회:
`npm {{[c|config]}} get {{키}}`
- 설정 키에 값을 지정:
`npm {{[c|config]}} set {{키}} {{value}}`
- 설정 키 삭제:
`npm {{[c|config]}} delete {{키}}`
- 기본 편집기로 전역 npm 설정 파일 수정:
`npm {{[c|config]}} edit`
- 잘못된 설정 항목 자동 수정 시도:
`npm {{[c|config]}} fix`
+16
View File
@@ -0,0 +1,16 @@
# npm deprecate
> `npm` 패키지의 특정 버전 또는 버전 범위를 사용 중단 권장(deprecated) 상태로 표시하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-deprecate/>.
- 특정 버전을 deprecated로 표시:
`npm deprecate {{패키지_이름}}@{{버전}} "{{사용중단_메시지}}"`
- 특정 버전 범위를 deprecated로 표시:
`npm deprecate {{패키지_이름}}@"<{{버전_범위}}" "{{사용중단_메시지}}"`
- 특정 버전의 deprecated 상태 해제:
`npm deprecate {{패키지_이름}}@{{버전}} ""`
+33
View File
@@ -0,0 +1,33 @@
# npm diff
> `npm` 레지스트리의 패키지 버전을 비교하여 차이점을 보여주는 명령어
> `git diff`와 유사하게 동작.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-diff/>.
- 두 특정 패키지 버전을 비교:
`npm diff --diff {{패키지_이름}}@{{버전1}} --diff {{패키지_이름}}@{{버전2}}`
- 현재 로컬 패키지와 최신 배포 버전 비교:
`npm diff`
- 현재 로컬 패키지와 특정 버전 비교:
`npm diff --diff {{패키지_이름}}@{{버전}}`
- 현재 디렉터리의 패키지와 레지스트리 버전 비교:
`npm diff --diff {{패키지_이름}}`
- 변경된 파일 이름만 출력:
`npm diff --diff-name-only --diff {{패키지_이름}}@{{버전1}} --diff {{패키지_이름}}@{{버전2}}`
- 특정 파일 또는 디렉터리만 비교:
`npm diff {{경로/대상/파일_또는_디렉터리}} --diff {{패키지_이름}}@{{버전1}} --diff {{패키지_이름}}@{{버전2}}`
- 공백 차이를 무시하고 비교:
`npm diff --diff-ignore-all-space --diff {{패키지_이름}}@{{버전1}} --diff {{패키지_이름}}@{{버전2}}`
+28
View File
@@ -0,0 +1,28 @@
# npm dist-tag
> 패키지의 배포 태그를 관리하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-dist-tag/>.
- 특정 패키지의 모든 배포 태그 목록 출력:
`npm dist-tag ls {{패키지_이름}}`
- 현재 패키지의 모든 배포 태그 목록 출력:
`npm dist-tag ls`
- 특정 패키지 버전에 배포 태그 추가:
`npm dist-tag add {{패키지_이름}}@{{버전}} {{태그}}`
- 패키지에서 배포 태그 제거:
`npm dist-tag rm {{패키지_이름}} {{태그}}`
- npm 설정에 지정된 기본 태그로 추가:
`npm dist-tag add {{패키지_이름}}@{{버전}}`
- 2단계 인증(OTP)을 사용해 태그 추가:
`npm dist-tag add {{패키지_이름}}@{{버전}} {{태그}} --otp {{일회용_비밀번호}}`
+12
View File
@@ -0,0 +1,12 @@
# npm docs
> 하나 이상의 패키지 문서를 기본 웹 브라우저에서 여는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-docs/>.
- 특정 패키지의 문서 페이지 열기:
`npm docs {{패키지}}`
- 여러 패키지의 문서 페이지를 한 번에 열기:
`npm docs {{패키지1 패키지2 ...}}`
+9
View File
@@ -0,0 +1,9 @@
# npm edit
> 현재 프로젝트의 의존성을 선택하여 해당 패키지 폴더를 기본 편집기 (`$EDITOR`)로 여는 명령어.
> 편집 후에는, 변경 사항이 반영되도록 패키지가 다시 빌드됨.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-edit/>.
- 로컬에 설치된 패키지를 기본 편집기로 열기:
`npm edit {{패키지_이름}}`
+24
View File
@@ -0,0 +1,24 @@
# npm exec
> `npm` 패키지 바이너리 실행.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-exec/>.
- 로컬 또는 원격 `npm` 패키지 명령어 실행:
`npm {{[x|exec]}} {{명령어}} {{argument1 argument2 ...}}`
- 특정 패키지를 명시하여 실행 (동일한 이름의 명령이 여러개 있을 때 유용):
`npm {{[x|exec]}} --package {{패키지}} {{명령어}}`
- `node_modules/.bin`에 존재하는 경우에만 실행:
`npm {{[x|exec]}} --no-install {{명령어}} {{인자1 인자2 ...}}`
- `npm` 자체 출력 없이 명령 실행:
`npm {{[x|exec]}} --quiet {{명령어}} {{인자1 인자2 ...}}`
- 도움말 표시:
`npm {{[x|exec]}} --help`
+20
View File
@@ -0,0 +1,20 @@
# npm explain
> 특정 패키지가 왜 설치되었는지, 의존성 관계와 포함 이유를 설명하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/explain/>.
- 특정 패키지가 설치된 이유 설명:
`npm {{[why|explain]}} {{패키지_이름}}`
- JSON 형식으로 설명 출력:
`npm {{[why|explain]}} {{패키지_이름}} --json`
- peer 의존성까지 포함하여 설명:
`npm {{[why|explain]}} {{패키지_이름}} --include peer`
- 설명 깊이를 2단계로 제한:
`npm {{[why|explain]}} {{패키지_이름}} --depth 2`
+12
View File
@@ -0,0 +1,12 @@
# npm explore
> 설치된 npm 패키지 디렉터리를 탐색하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-explore/>.
- 설치된 패키지 탐색:
`npm explore {{패키지_이름}}`
- 패키지 탐색 및 내부에서 명령어 실행:
`npm explore {{패키지_이름}} -- {{명령어}}`
+12
View File
@@ -0,0 +1,12 @@
# npm help-search
> 키워드를 사용해 npm 도움말 문서 보기.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-help-search/>.
- 키워드와 관련된 명령 또는 주제 검색:
`npm help-search {{키워드}}`
- 여러 단어로 검색:
`npm help-search {{키워드1 키워드2 ...}}`
+8
View File
@@ -0,0 +1,8 @@
# npm help
> `npm` 명령어의 문법, 자주 사용하는 명령, 각 명령에 대한 간단한 설명을 보여주는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-help/>.
- 특정 명령어에 대한 문서 보기:
`npm help {{명령어}}`
+21
View File
@@ -0,0 +1,21 @@
# npm hook
> 패키지를 위한 `npm` 레지스트리 훅을 관리하는 명령어.
> 참고: 이 명령어는 현재 deprecated 상태입니다.
> 더 많은 정보: <https://docs.npmjs.com/cli/v10/hook/>.
- 활성화된 모든 훅 목록 출력:
`npm hook ls`
- 특정 패키지에 새로운 훅 추가:
`npm hook add {{패키지_이름}} {{이벤트}} {{타겟_주소}}`
- ID로 특정 훅 제거:
`npm hook rm {{훅_아이디}}`
- 새로운 정보로 훅 업데이트:
`npm hook update {{훅_아이디}} {{타겟_주소}}`
+13
View File
@@ -0,0 +1,13 @@
# npm install-ci-test
> 프로젝트 의존성을 설치하고 테스트를 실행하는 명령어로, 주로 CI(지속적 통합) 환경에서 사용됨.
> `npm ci && npm test` 실행과 동일한 동작.
> 더 많은 정보: <https://docs.npmjs.com/cli/install-ci-test/>.
- 의존성 설치 후 테스트 실행:
`npm {{[cit|install-ci-test]}}`
- 설치 및 테스트 과정의 상세 로그 출력:
`npm {{[cit|install-ci-test]}} --verbose`
+21
View File
@@ -0,0 +1,21 @@
# npm install-test
> `npm install` 후 `npm test`를 실행하는 것과 동일한 명령어.
> 참고: `it`은 `install-test`의 단축 명령으로 사용할 수 있음.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-install-test/>.
- 모든 의존성 설치 후 테스트 실행:
`npm {{[it|install-test]}}`
- 특정 패키지 설치 후 테스트 실행:
`npm {{[it|install-test]}} {{패키지_이름}}`
- 패키지를 의존성으로 저장한 후 테스트 실행:
`npm {{[it|install-test]}} {{패키지_이름}} {{[-S|--save]}}`
- 전역으로 의존성 설치 후 테스트 실행:
`npm {{[it|install-test]}} {{[-g|--global]}}`
+16
View File
@@ -0,0 +1,16 @@
# npm link
> 로컬 패키지를 전역 `node_modules` 또는 다른 프로젝트에서 심볼릭 링크로 연결하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-link/>.
- 현재 패키지를 전역으로 링크:
`npm {{[ln|link]}}`
- 전역에 링크된 패키지를 다른 프로젝트의 `node_modules`에 연결:
`npm {{[ln|link]}} {{패키지_이름}}`
- 현재 프로젝트에서 패키지 링크 해제:
`npm {{[r|unlink]}} {{패키지_이름}}`
+17
View File
@@ -0,0 +1,17 @@
# npm login
> 레지스트리 사용자 계정에 로그인.
> 관련 항목: `npm logout`.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-login/>.
- 레지스트리 계정에 로그인하고 인증 정보를 `.npmrc` 파일에 저장:
`npm login`
- 사용자 정의 레지스트리로 로그인:
`npm login --registry {{레지스트리_주소}}`
- 특정 인증 방식으로 로그인:
`npm login --auth-type {{legacy|web}}`
+13
View File
@@ -0,0 +1,13 @@
# npm logout
> 레지스트리 사용자 계정에서 로그아웃 명령어.
> 관련 항목: `npm login`.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-logout/>.
- 레지스트리 계정에서 로그아웃:
`npm logout`
- 사용자 정의 레지스트리에서 로그아웃:
`npm logout --registry {{레지스트리_주소}}`
+28
View File
@@ -0,0 +1,28 @@
# npm ls
> 설치된 패키지를 `stdout`로 출력.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-ls/>.
- 현재 프로젝트의 직접 의존성 버전을 `stdout`으로 출력:
`npm {{[ls|list]}}`
- peer 의존성을 포함한 모든 패키지 출력:
`npm {{[ls|list]}} {{[-a|--all]}}`
- 전역으로 설치된 모든 패키지 출력:
`npm {{[ls|list]}} {{[-g|--global]}}`
- 확장 정보와 함께 의존성 출력:
`npm {{[ls|list]}} {{[-l|--long]}}`
- 파싱 가능한 형식으로 출력:
`npm {{[ls|list]}} {{[-p|--parseable]}}`
- JSON 형식으로 출력:
`npm {{[ls|list]}} --json`
+24
View File
@@ -0,0 +1,24 @@
# npm pack
> 패키지로부터 tarball 파일을 생성하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/pack/>.
- 현재 디렉터리의 패키지로 tarball 생성:
`npm pack`
- Create a tarball from a specific package folder:
`npm pack {{path/to/package_directory}}`
- Run a dry run to preview the tarball contents without creating it:
`npm pack --dry-run`
- Create a tarball without running lifecycle scripts:
`npm pack --ignore-scripts`
- Specify a custom registry to fetch package metadata from:
`npm pack --registry {{https://registry.npmjs.org/}}`
+12
View File
@@ -0,0 +1,12 @@
# npm ping
> `npm` 레지스트리에 ping을 전송하여 연결 가능한지 확인하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-ping/>.
- 기본 `npm` 레지스트리 ping 전송:
`npm ping`
- 사용자 정의 `npm` 레지스트리 ping 전송:
`npm ping --registry {{사용자정의_레지스트리_주소}}`
+36
View File
@@ -0,0 +1,36 @@
# npm pkg
> `package.json`의 속성을 조회하거나 수정하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-pkg/>.
- 특정 속성 값을 조회:
`npm pkg get {{이름}}`
- 여러 속성 값 한 번에 조회:
`npm pkg get {{이름|버전|...}}`
- 모든 워크스페이스에서 여러 값 조회:
`npm pkg get {{이름}} {{버전}} {{[--ws|--workspaces]}}`
- 중첩 또는 배열 속성 값 조회:
`npm pkg get {{contributors[0].email}}`
- 속성을 특정 값으로 설정:
`npm pkg set {{속성}}={{값}}`
- 여러 속성 한 번에 설정:
`npm pkg set {{속성1}}={{값1}} {{속성2}}={{값2}}`
- `package.json`에서 특정 속성 삭제:
`npm pkg delete {{scripts.build}}`
- `package.json`의 일반적인 오류 자동 수정:
`npm pkg fix`
+12
View File
@@ -0,0 +1,12 @@
# npm prefix
> 로컬 또는 전역 prefix 경로를 `stdout`으로 출력하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-prefix/>.
- 로컬 prefix 출력:
`npm prefix`
- 전역 prefix 출력:
`npm prefix {{[-g|--global]}}`
+37
View File
@@ -0,0 +1,37 @@
# npm profile
> npm 프로필과 관련 설정을 관리하는 명령어.
> 참고: 이 명령어는 workspaces를 지원하지 않음.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-profile/>.
- npm 프로필 정보 조회:
`npm profile get`
- 특정 프로필 속성 조회:
`npm profile get {{속성}}`
- Set or update a profile property:
`npm profile set {{속성}} {{값}}`
- 공개 이메일 주소 설정:
`npm profile set email {{이메일}}`
- 공개 이름 설정:
`npm profile set fullname {{이름}}`
- 새로운 비밀번호를 대화형으로 설정:
`npm profile set password`
- 2단계 인증(2FA) 활성화 (기본: `auth-and-writes`):
`npm profile enable-2fa {{auth-only|auth-and-writes}}`
- 2단계 인증(2FA) 비활성화:
`npm profile disable-2fa`
+25
View File
@@ -0,0 +1,25 @@
# npm prune
> `node_modules`에서 불필요한 패키지를 제거하는 명령어.
> 참고: 불필요한 패키지는 어떤 패키지의 의존성 목록에도 포함되지 않은 패키지를 의미.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-prune/>.
- 의존성에 포함되지 않은 모든 불필요한 패키지 제거:
`npm prune`
- 불필요한 패키지와 devDependencies 제거 (프로덕션 빌드에 유용):
`npm prune --production`
- 실제 변경 없이 제거 대상 미리보기:
`npm prune --dry-run`
- 변경 내용을 JSON 형식으로 출력:
`npm prune --json`
- 특정 패키지 이름으로 제거:
`npm prune {{패키지_이름}}`
+36
View File
@@ -0,0 +1,36 @@
# npm publish
> 패키지를 npm 레지스트리에서 배포.
> 더 많은 정보: <https://docs.npmjs.com/cli/publish/>.
- 현재 패키지를 기본 npm 레지스트리에 배포:
`npm publish`
- 특정 디렉터리의 패키지 배포:
`npm publish {{경로/대상/패키지_디렉터리}}`
- 특정 사용자나 조직(namespace)에 속한 패키지를 공개(public)로 배포:
`npm publish --access public`
- 특정 사용자나 조직(namespace)에 속한 패키지를 비공개(private) 배포:
`npm publish --access restricted`
- 사용자 정의 레지스트리에 패키지 배포:
`npm publish --registry {{https://registry.npmjs.org/}}`
- 실제 업로드 없이 배포 내용 미리보기:
`npm publish --dry-run`
- 특정 배포 태그로 배포 (예: beta):
`npm publish --tag {{beta}}`
- 2단계 인증(2FA)을 위한 OTP를 사용하여 배포:
`npm publish --otp {{일회용_비밀번호}}`
+28
View File
@@ -0,0 +1,28 @@
# npm rebuild
> Node 또는 의존성 변경 후 네이티브 Node.js 패키지를 다시 빌드하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-rebuild/>.
- 특정 패키지 재빌드:
`npm {{[rb|rebuild]}} {{패키지}}`
- 모든 설치된 패키지 재빌드:
`npm {{[rb|rebuild]}}`
- 상세 출력과 함께 재빌드:
`npm {{[rb|rebuild]}} --verbose`
- 특정 디렉터리에서 패키지 재빌드:
`npm {{[rb|rebuild]}} --prefix {{경로/대상/디렉터리}} {{패키지}}`
- npm 캐시를 사용하지 않고 재빌드:
`npm {{[rb|rebuild]}} --no-cache`
- 전역 모드에서 재빌드:
`npm {{[rb|rebuild]}} {{[-g|--global]}}`
+28
View File
@@ -0,0 +1,28 @@
# npm repo
> 패키지의 저장소 페이지를 브라우저에서 여는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-repo/>.
- 현재 프로젝트 (`package.json` 기준)의 저장소 페이지 열기:
`npm repo`
- 레지스트리 내 특정 패키지의 저장소 페이지 열기:
`npm repo {{패키지_이름}}`
- 여러 패키지의 저장소 페이지 한 번에 열기:
`npm repo {{패키지_이름1 패키지_이름2 ...}}`
- 브라우저를 열지 않고 저장소 URL 출력:
`npm repo --browser false`
- 특정 브라우저로 저장소 페이지 열기:
`npm repo --browser {{브라우저_이름}}`
- 특정 워크스페이스의 패키지 저장소 페이지 열기:
`npm repo --workspace {{워크스페이스_이름}}`
+16
View File
@@ -0,0 +1,16 @@
# npm sbom
> Node.js 프로젝트의 Software Bill of Materials (SBOM)을 생성하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-sbom/>.
- 프로젝트의 모든 의존성 목록 출력:
`npm sbom`
- `dev``optional` 의존성 제외:
`npm sbom --omit dev --omit optional`
- 오직 `package-lock.json`을 기반으로 SBOM 생성:
`npm sbom --package-lock-only`
+17
View File
@@ -0,0 +1,17 @@
# npm shrinkwrap
> 패키지의 의존성을 고정해, `npm-shrinkwrap.json` 파일을 생성하는 명령어.
> `package-lock.json`와 유사하지만 배포용 패키지에 사용됨.
> 더 많은 정보: <https://docs.npmjs.com/cli/shrinkwrap/>.
- 현재 `package-lock.json`을 기반으로 `npm-shrinkwrap.json` 생성:
`npm shrinkwrap`
- 프로덕션 모드로 실행 (devDependencies 제외):
`npm shrinkwrap --production`
- 이미 존재해도 강제로 shrinkwrap 파일 재생성:
`npm shrinkwrap --force`
+24
View File
@@ -0,0 +1,24 @@
# npm stars
> 즐겨찾기로 표시한 패키지를 조회하는 명령어.
> 더 많은 정보: <https://docs.npmjs.com/cli/npm-stars/>.
- 현재 로그인한 사용자의 즐겨찾기 패키지 목록 출력:
`npm stars`
- 특정 레지스트리에서 즐겨찾기 패키지 조회:
`npm stars --registry {{레지스트리_주소}}`
- 특정 사용자가 즐겨찾기한 패키지 목록 출력:
`npm stars {{사용자명}}`
- 특정 레지스트리에서 특정 사용자의 즐겨찾기 패키지 조회:
`npm stars {{사용자명}} --registry {{레지스트리_주소}}`
- 도움말 표시:
`npm stars {{[-h|--help]}}`