Feature フラグ

Lindera は Cargo の feature フラグを使用して、オプション機能と辞書の埋め込みを制御します。

コア Feature

• mmap はメインの lindera クレートでデフォルトで有効です。
• 分析チェーン（character filter・token filter・Tokenizer）は本クレートの feature ではありません。v5.0 以降は独立クレート lindera-analysis が提供します。 lindera クレート自体は Segmenter API を中心とした純粋な形態素分割器です。
• train は lindera-cli・lindera-python・lindera-nodejs・lindera-ruby・lindera-php ではデフォルトで有効です。コアライブラリである lindera クレートではデフォルトで無効なので、ライブラリとして使用する場合は features = ["train"] で明示的に有効にしてください。lindera-wasm では利用できません。

外部辞書の使用（推奨）

推奨される方法は、ビルド済み辞書を外部ファイルとして使用することです。GitHub Releases から辞書をダウンロードし、実行時にそのパスを指定してください：

#![allow(unused)]
fn main() {
let dictionary = load_dictionary("/path/to/ipadic")?;
}

この使用方法では、追加の feature フラグは不要です。

辞書埋め込み Feature（上級者向け）

これらの feature はビルド済み辞書をバイナリに直接埋め込み、実行時に外部辞書ファイルを不要にします。自己完結型バイナリが必要な上級者向けの機能です。

いずれもデフォルトでは無効です。必要に応じて有効にしてください：

[dependencies]
lindera = { version = "5", features = ["embed-ipadic"] }

埋め込みを有効にした場合、以下のように辞書を読み込めます：

#![allow(unused)]
fn main() {
let dictionary = load_dictionary("embedded://ipadic")?;
}

[!NOTE] 辞書データには Lindera 本体とは別のライセンスが適用されます。辞書を埋め込んだ バイナリを配布する場合（またはビルド済み辞書を再配布する場合）は、対応する 辞書クレートの NOTICE.txt（例: lindera-unidic/NOTICE.txt）に記載された 帰属表示を、配布物に付属するドキュメントや資料に転載してください。

組み合わせ Feature

多言語アプリケーション向けに、複数の辞書を一度に有効にするメタ Feature です。

Feature フラグの組み合わせ

複数の feature フラグを組み合わせることができます。例えば、日本語と韓国語の辞書を両方埋め込む場合：

[dependencies]
lindera = { version = "5", features = ["embed-ipadic", "embed-ko-dic"] }

またはコマンドラインから：

cargo build --features embed-ipadic,embed-ko-dic

注意事項

• 辞書の埋め込みはバイナリサイズを大幅に増加させます。実際に必要な辞書のみを埋め込んでください。
• train feature は lindera-crf への依存を追加し、コンパイル時間が増加します。トークナイズのみのユースケースでは不要です。
• mmap feature はファイルシステム辞書に対するメモリマップド読み込みを有効にします（CLIの--mmapまたはsegmenter設定のuse_mmapキーで要求）。辞書フォーマットバージョン 2 以降、トライ（dict.trie/dict.valsidx）もシリアライズ済みバイト列上を直接走査するため、単語リストファイル（dict.vals/dict.wordsidx/dict.words）・接続コスト行列（matrix.mtx）と合わせて、大きなコンポーネントはすべて遅延読み込みされ、匿名メモリを消費しません。ロード時に全体がメモリに展開されるコンポーネントはありません。埋め込み辞書には影響しませんが、埋め込み辞書のトライと接続コスト行列もバイナリ内から直接参照されます。