プロジェクト全体で命名を統一するためのチェックリストです。初心者でも使いやすいように整理しました。
モジュール名
- [ ] 接頭辞を付ける（例：
mod、cls、frm） - [ ] 役割が分かる名前（例：
modCalc、clsCustomer、frmLogin） - [ ] 機能ごとに分ける（計算、データ管理、UIなど）
プロシージャ名（Sub / Function）
- [ ] 動詞＋目的語で命名（例：
ShowMessage、GetTotal、ExportData） - [ ] 処理内容が分かる名前を付ける
- [ ] Functionは戻り値を意識した名前（例：
IsValidUser→ True/Falseを返す）
変数名
- [ ] 意味が分かる名前（例：
userName、sum、count） - [ ] 型を示す接頭辞を付ける場合は統一
strName（文字列）intCount（整数）rngData（Range型）wsReport（Worksheet型）
- [ ] スコープに応じて命名を工夫（グローバル変数は特に注意）
定数名
- [ ] すべて大文字＋アンダースコア（例：
MAX_COUNT、DEFAULT_PATH） - [ ] 意味が明確（何の定数か一目で分かる）
名前空間・接頭辞
- [ ] プロジェクト接頭辞を統一（例：
HR_、INV_） - [ ] 機能ごとの接頭辞を統一（例：
User_、Report_、Data_） - [ ] 衝突防止のために一貫性を持たせる
一般ルール
- [ ] 英語ベースで統一（日本語はコメントで補足）
- [ ] 略語は最小限に（誰でも理解できる名前にする）
- [ ] 一貫性を守る（同じ処理は同じ命名パターン）
- [ ] 長すぎず短すぎず（意味が分かる範囲で簡潔に）
運用のポイント
- チームで命名規則ドキュメントを共有する
- 新しい名前を付けるときは既存ルールに従う
- 定期的にレビューして統一感を保つ
💡 このチェックリストを「コードレビュー時の確認項目」として使うと効果的です。
