gpdf は標準ライブラリだけで動く Go の PDF ライブラリです。12 カラムのグリッドでページを組み、日本語・中国語・韓国語のフォントを埋め込み、1 ページを約 13 µs で描画します。
go.mod にあるのは Go 本体だけ。cgo もヘッドレスブラウザも、サービスの横に置くネイティブバイナリもいりません。
行と 12 カラムのグリッドがページに流れ込みます。表はページをまたいで分かれ、文字は自動で折り返します。
TrueType フォントは使った字形だけをサブセット化。日本語・中国語・韓国語がどのサーバーでも同じ見た目になります。
ベンチマーク
同じ 4 つの文書を gpdf・go-pdf/fpdf・signintech/gopdf・maroto v2 で作りました。1 文書あたりの時間とメモリ。小さいほど良い値です。
5 回の中央値、各 100 回の反復。Apple M1、Go 1.25。ベンチマークのコードは gpdf のリポジトリにあります。
ベンチマークのコードを見るGo ネイティブの設計
Go で PDF を作る多くの構成は、言語の外に頼ります。サイドカーのヘッドレスブラウザ、HTTP 越しの HTML→PDF サービス、ネイティブライブラリへのバインディング。どれもデプロイし、パッチを当て、監視するランタイムが 1 つ増えます。
gpdf は最初の 1 行から Go で書かれています。あなたのバイナリに組み込まれ、Go が動く場所ならどこでも動き、依存ツリーは標準ライブラリだけ。セキュリティチームが追加で監査するものはありません。
go get を 1 回、バイナリは 1 つ。開発でも本番でも同じ出力です。
あなたの Go アプリ
HTTP 呼び出し / cgo バインディングヘッドレスブラウザ · JVM · ネイティブライブラリ
デプロイし、パッチを当て、監視するランタイムがまた 1 つ。
あなたの Go アプリ
go getgithub.com/gpdf-dev/gpdf
バイナリ 1 つ · 標準ライブラリのみ · cgo なし
動く環境
CJK を最優先に
多くの PDF ライブラリは CJK を後回しにします。gpdf は最初から CJK を前提に作られています。
どの TrueType フォントも埋め込めます。ファイルに書くのは使った字形だけです。
日本語・中国語・韓国語・欧文を 1 つの段落や表に混ぜられます。
豆腐(□)も文字化けもなし。サーバーに入っているフォントに左右されません。
長期保存、セキュリティ、後処理も同じモジュールに入っています。それでも依存は Go の標準ライブラリだけです。
XMP メタデータつきの PDF/A-1b・PDF/A-2b。何十年も読める必要がある文書に。
所有者・利用者のパスワードと、印刷・コピー・編集の権限設定。
RFC 3161 タイムスタンプつきの PKCS#7 署名を、できあがった PDF に付けます。
全ページにくり返すヘッダー・フッターとページ番号。
QR と Code 128 をそのまま生成。PNG・JPEG の画像と並べられます。
Go の中で PDF を結合し、ページ範囲を取り出せます。
gpdf とほかの選択肢
何をデプロイし、何にお金を払い、何にパッチを当て続けるのか。
スタックに合う入口を選んでください。3 つとも同じ描画エンジンを通ります。
go get github.com/gpdf-dev/gpdf。Go 1.22 以降で動きます。
型安全な流れるような Go:PageBuilder → RowBuilder → ColBuilder。
文書を JSON で書き、どのサービス・言語からでも送れます。
text/template で JSON スキーマを動かし、1 つの元から何千もの文書を。
請求書・領収書・見積書をコピーして手直しできます。
どのサンプルも本物の PDF を描くテスト。表から署名まで。
リリースのたびに、どのサンプルも保存した PDF とバイト単位で比べます。
生成したファイルを CI で PDF の仕様に照らして検証します。
対応するすべての Go のバージョンで、レース検出つきで全テストを流します。
Go で帳票 PDF を作る — 仕訳帳・総勘定元帳・残高試算表
2026年11月14日
gpdf のフッターに「Page X of Y」を 1 行で出すには?
2026年11月12日
2026年11月10日
2026年9月2日
FAQ
gpdf は外部依存ゼロの純 Go で書かれた、MIT ライセンスの PDF 生成ライブラリです。12 カラムのグリッドでページを組み、日本語・中国語・韓国語を含む TrueType フォントを埋め込みます。
1 ページを約 13 µs で描画します。公開しているベンチマークでは、多くの文書で go-pdf/fpdf・signintech/gopdf・maroto v2 よりおよそ 10〜30 倍速く動きます。
はい。TrueType フォントを埋め込むと、gpdf は使った字形だけを書き出します。出力はサーバーに入っているフォントに左右されません。
はい。gpdf は MIT ライセンスなので、商用製品での利用・改変・再配布ができます。
Go 1.22 以降です。CI では Go 1.22〜1.26 でテストを流しています。