【チェンジログ】

CHANGELOG とは?

💡 ソフトウェアの「成長日記」、何がいつ変わったか一目でわかる
📌 このページのポイント
CHANGELOGの構造 v2.1.0 (2026-04-01) Added ダーク モード対応 Changed 検索UIを刷新 Fixed ログイン時のエラー修正 v2.0.0 (2026-03-15) Removed 旧APIのサポート終了 Added 新しい認証フロー Security XSS脆弱性を修正 Keep a Changelog カテゴリ Added 新機能 Changed 変更 Deprecated 非推奨化 Removed 削除 📄 CHANGELOG.md プロジェクトルートに配置 新しいバージョンが上に来る
CHANGELOGの構造とカテゴリ分類のイメージ
ひよこ ひよこ

CHANGELOGって何のために書くの?

ペンギン先生 ペンギン先生

ソフトウェアが「いつ、何が変わったか」を記録するためのドキュメントだよ。ユーザーがバージョンアップするときに「今回のアップデートで何が変わるの?」を確認できるようにする、いわば変更の履歴書だね。

ひよこ ひよこ

Gitのコミットログとは違うの?

ペンギン先生 ペンギン先生

いい質問だね。コミットログは開発者が細かい作業単位で残すメモで、数百件にもなるよ。CHANGELOGはそれを人間が読みやすいようにまとめたもので、「このバージョンでは何が追加されて、何が修正されたか」がすぐわかるように整理されているんだ。

ひよこ ひよこ

どうやって書くの?決まった形式はあるの?

ペンギン先生 ペンギン先生

「Keep a Changelog」という有名な書き方ガイドがあるよ。Added(追加)、Changed(変更)、Deprecated(非推奨化)、Removed(削除)、Fixed(修正)、Security(セキュリティ修正)の6カテゴリに分けて書くのが推奨されているんだ。

ひよこ ひよこ

自動で作れたりしないの?

ペンギン先生 ペンギン先生

conventional-changelog や standard-version のようなツールを使えば、コミットメッセージから自動生成できるよ。ただしコミットメッセージを「feat:」「fix:」のような規約に従って書く必要があるんだ。Conventional Commits という規約が有名だね。

ひよこ ひよこ

CHANGELOGを書かないとどうなるの?

ペンギン先生 ペンギン先生

ユーザーがバージョンアップを怖がるようになるよ。「何が変わったかわからないからアップデートしたくない」と思われてしまうんだ。特に破壊的変更があるのにCHANGELOGに書いていないと、アップデートした人のシステムが壊れてクレームの嵐になることもあるよ。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「CHANGELOG」って出てきたら「ソフトウェアの変更履歴をバージョン別にまとめたファイル」と思えればだいたいOK!
📖 おまけ:英語の意味
「Change Log」 = 変更記録
💬 change(変更)とlog(記録)を組み合わせた言葉で、プロジェクトのルートに CHANGELOG.md として置くのが慣習だよ
← 用語集にもどる