複数の担当者がWeb素材を管理していると、同じ画像なのにファイル名がバラバラで、どれが最新版か分からなくなる場面があります。もし社内でファイルの受け渡しや差し替えが頻繁に発生しているなら、命名規則を整えるだけで作業ミスを減らせます。この記事では、種別・用途・版数を一目で識別できるファイル命名の考え方と、実際に運用できる手順を説明します。
命名規則を整える目的と対象
ファイル命名規則の目的は、ファイルを開かずに内容と状態を判断できるようにすることです。対象は画像・動画・CSS・JavaScript・フォントなど、Webサイトを構成するすべての素材ファイルです。
命名規則が整っていない場合、同名のファイルが上書きされたり、旧版が誤って公開されたりするリスクがあります。反対に規則が統一されていれば、新しく参加したメンバーでもディレクトリを見ただけで素材の役割を把握しやすくなります。保守・運用の記事でもたびたび取り上げられるテーマですが、命名規則はファイル管理の出発点といえます。
命名規則を設計するときの判断基準
命名規則を決める前に、何を優先するかを明確にする必要があります。主な判断軸は次の三つです。
- 識別性：ファイル名だけで種別・用途・版数を読み取れるかどうかを確認してください。
- 一貫性：担当者が変わっても同じルールを適用できるかどうかを見極めてください。
- 拡張性：新しいカテゴリや言語対応が加わったときに規則を崩さずに済むかどうかを検討してください。
チームの規模が小さい場合でも、識別性と一貫性を最低限確保しておくと後の運用が楽になります。大規模なサイトであれば、拡張性を重視して要素の順序や区切り文字を厳密に定義しておくとよいでしょう。
また、ファイル名に使用できる文字についても事前に制約を確認しておきましょう。サーバー環境やCDNによっては日本語や半角スペースが問題を起こすことがあります。実際に使用する環境の仕様は各サービスの公式ドキュメントで確認してください。英小文字・数字・ハイフン・アンダースコアの組み合わせに限定しておくと、環境依存のトラブルを避けやすくなります。
ファイル名を構成する要素の選び方
命名規則では、ファイル名に含める要素とその順序を決めます。一般的に使われる要素は以下のとおりです。
- 種別
- ファイルの大まかな分類を示します。例として
img（画像）、icon（アイコン）、bg（背景）、video（動画）などが挙げられます。 - 用途・ページ名
- どのページや機能で使うかを示します。例として
top（トップページ）、about（会社案内）、nav（ナビゲーション）などが使われます。 - 内容・説明
- ファイルの具体的な内容を短い英単語で表します。例として
hero、logo、thumbnailなどです。 - バリアント
- サイズ・色・デバイス対応などの違いを区別するための修飾子です。例として
2x、sp（スマートフォン用）、whiteなどが使われます。 - 版数
- 修正の世代を管理するための番号です。例として
v1・v2やr01・r02のように表記します。
これらを組み合わせる順序は、種別 → 用途 → 内容 → バリアント → 版数の順にするとファイル一覧での並び順が整いやすくなります。区切り文字はハイフン（-）かアンダースコア（_）のどちらかに統一し、混在させないことが大切です。
要素の数が多すぎるとファイル名が長くなり、かえって可読性が下がることがあります。最初は種別・用途・内容の三要素から始め、バリアントや版数は必要に応じて追加する方針にしておくと、規則がシンプルに保ちやすくなります。
命名規則を実際に導入する手順と進め方
規則を決めても、既存ファイルへの適用方法と新規ファイルへの徹底方法を決めなければ形骸化します。次の順序で進めると、運用開始後の混乱を減らせます。
- 現状の棚卸し：既存のファイル一覧を書き出し、種別・用途・版数の三軸で分類できるかを確認します。分類できないファイルがあれば、名前の付け方の問題なのか、素材の整理が必要なのかを切り分けておきましょう。
- 命名規則のドラフト作成：要素の種類・順序・区切り文字・使用できる文字を一覧にまとめます。具体例を複数添えると、メンバーが迷ったときに参照しやすくなります。
- サンプルファイルで検証：新しい規則を少数のサンプルファイルに適用し、名前だけで内容を識別できるかをチームで確認します。問題があれば規則を修正してください。
- 既存ファイルの移行計画：全ファイルを一度にリネームすると参照エラーが発生しやすいため、ページ単位や機能単位で段階的に移行する計画を立てます。リネーム前後の対応表を記録しておくと後から追跡しやすくなります。
- ルールのドキュメント化と共有：命名規則を社内Wikiや共有ドキュメントに記載し、新しいメンバーがすぐ参照できる場所に置きます。更新のたびにドキュメントも改訂する運用フローを決めておきましょう。
- 定期的な棚卸しのスケジュール化：規則に沿っていないファイルが増えないよう、定期的にファイル一覧を見直すタイミングを決めます。保守・運用サービスとして外部に委託している場合も、命名規則の共有と確認を契約に含めておくと安心です。
運用時に起こりやすい注意点とリスク
命名規則を導入した後も、いくつかの落とし穴があります。あらかじめ把握しておくと、トラブルを防ぎやすくなります。
版数の管理が属人化するリスクがあります。版数の付け方をメンバーに任せると、_final・_fix・_new のような意味が曖昧な接尾辞が混入しやすくなります。版数は数字のみ、もしくはプレフィックス付きの数字（v2 など）に限定するルールを明文化することで、この問題を回避できます。
バリアントの定義が増えすぎる問題も起こりがちです。デバイス対応・言語・カラーバリエーションが増えると、ファイル名が長くなりすぎて可読性が下がります。バリアントの種類は必要最小限に絞り、それ以上の情報はディレクトリ構造で表現することを検討してください。
大文字・小文字の扱いについては、サーバー環境によって動作が異なる場合があります。使用しているサーバーやホスティングサービスの公式ドキュメントで大文字・小文字の区別に関する仕様を確認してください。環境差異によるトラブルを防ぐためにも、ファイル名はすべて英小文字で統一するルールにしておくとよいでしょう。
命名規則自体が更新されないリスクもあります。サイトが拡張されるにつれて規則が実態に合わなくなるため、規則を見直す機会を定期的に設けることが大切です。規則を改訂した場合は、改訂日とバージョン番号をドキュメントに残しておくと変更の経緯を追いやすくなります。
命名規則の設計・運用チェックリスト
命名規則を整備・適用する前に、以下の項目を確認してください。体制や規模によって優先順位は変わりますが、基本的な確認項目として参考にしてください。
- 使用する要素（種別・用途・内容・バリアント・版数）とその順序を決めてあるか
- 区切り文字をハイフンかアンダースコアの一方に統一しているか
- ファイル名に使える文字（英小文字・数字・記号）の範囲を明示しているか
- 版数の表記形式（
v1など）を規則として決めてあるか _final・_newなどの曖昧な接尾辞を禁止するルールを設けているか- 命名規則をドキュメント化し、チームがすぐ参照できる場所に置いてあるか
- 既存ファイルの移行計画と、リネーム前後の対応表を用意しているか
- 大文字・小文字の扱いを公式ドキュメントで確認し、チームに周知しているか
- 定期的な棚卸しと規則の見直しのスケジュールを決めてあるか
- 命名規則を外部委託先とも共有しているか
命名規則は一度決めたら終わりではなく、サイトの成長に合わせて継続的に見直すものです。小さなチームでも、最低限の要素と区切り文字を統一しておくだけで素材管理の手間を着実に減らせます。運用方針についてより詳しく相談したい場合は、お問い合わせからご連絡ください。
