allegro/bigcache

これは何？

主な機能

• 01GCの停止時間を短縮するため、エントリをヒープ上のbyte sliceとして保存します。
• 02読み書きの並行処理に対応したシャーディング設計です。
• 03LifeWindowとCleanWindowによる時間ベースの削除に対応します。
• 04HardMaxCacheSizeでメモリ使用量に任意の上限を設定できます。
• 05期限切れ、容量超過、削除時に呼び出されるコールバックを設定できます。
• 06キャッシュを基盤とするHTTPサーバーパッケージが含まれています。

ユースケース

• 長時間稼働するGoサービスで、シリアライズ済みデータを数GB規模でキャッシュする。
• 数百万件のキャッシュエントリを保持するサービスで、GC負荷を抑える。
• 有効期限を設定できるローカルのプロセス内キャッシュを提供する。

クイックスタート

1. 1

   Go プロジェクトに BigCache v3 モジュールを追加する

2. 2

   デフォルト設定（有効期間は10分）でキャッシュを作成する

3. 3

   エントリをバイトスライスとして設定・取得する

使う前に知っておきたいこと

• !エントリはバイトスライスにシリアライズする必要があるため、多くの用途では追加のシリアライズ／デシリアライズ処理が必要です。
• !BigCache はハッシュ衝突を処理しません。ハッシュが衝突すると、新しいアイテムが既存の値を上書きします。

トピック

よくある質問

bigcache とは？

大量のエントリをヒープ上に保持しながらGC負荷を抑える、Go向けの高速な並行処理対応・自動削除型インメモリキャッシュ。 BigCacheは、ガベージコレクターによってプログラムの処理速度が落ちないよう、大量のエントリを保持できる設計のGo向けインメモリキャッシュライブラリです。エントリはGCが個別に走査しないbyte sliceとしてヒープ上に保持されるため、多くのユースケースでは値をbyte列にシリアライズしてから保存します。

bigcache は無料で使えますか？ライセンスは？

bigcache は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

bigcache は今もメンテナンスされていますか？

活発にメンテナンス中。bigcache の最終コミットは 2026年10月12日 です。

bigcache は何に使えますか？

長時間稼働するGoサービスで、シリアライズ済みデータを数GB規模でキャッシュする。 数百万件のキャッシュエントリを保持するサービスで、GC負荷を抑える。 有効期限を設定できるローカルのプロセス内キャッシュを提供する。

bigcache のインストール方法は？

Go プロジェクトに BigCache v3 モジュールを追加する デフォルト設定（有効期間は10分）でキャッシュを作成する エントリをバイトスライスとして設定・取得する

bigcache はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/allegro/bigcache