설치

Gukhanmun은 같은 API를 공유하는 두 개의 JavaScript 구현을 제공합니다:

패키지	환경	비고
`@gukhanmun/wasm`	브라우저, Node.js 20+, Deno 2.0+, Bun 1.0+	넓은 호환성을 위해 권장
`@gukhanmun/napi`	Node.js 20+, Deno 2.0+, Bun 1.0+	서버에서 더 빠름; 네이티브 코드

대부분의 프로젝트에서는 @gukhanmun/wasm을 사용합니다. 처리량이 중요한 서버 작업부하에는 @gukhanmun/napi로 바꿉니다.

WebAssembly

대부분의 환경에서 WebAssembly 구현이 최선의 선택입니다. 브라우저·Node.js·Deno·Bun 에서 동작하며 네이티브 코드를 필요로 하지 않습니다. 선호하는 패키지 관리자로 설치합니다:

npm

yarn

pnpm

bun

deno

npm add @gukhanmun/wasm

네이티브 애드온과 함께 Node.js·Deno·Bun을 쓰려면:

npm

yarn

pnpm

bun

deno

npm add @gukhanmun/napi

JavaScript 패키지는 《표준국어대사전》을 내장하지 않습니다. 별도로 설치합니다:

npm

yarn

pnpm

bun

deno

npm add @gukhanmun/stdict-fst

npm

yarn

pnpm

bun

deno

npm add @gukhanmun/stdict-cdb

두 패키지는 같은 사전을 담고 있습니다; 두 형식은 찾기 특성에서 차이가 납니다. 대부분의 용례에서는 FST 패키지를 선호합니다.

@gukhanmun/napi는 다음을 위한 미리 빌드된 바이너리를 포함합니다:

Alpine Linux(musl)는 소스에서 빌드해야 합니다.