ファイル名の命名規則ルールと例｜版番号の付け方・フォルダ構成

文書ファイルの名前は「日付_案件_文書名_版.拡張子」の順に固定すると、並べ替えるだけで時系列になり、名前だけで中身と状態がわかります。 この記事は、設計書・議事録・見積書といった文書ファイルの名前とフォルダの決め方を扱います。プログラムの変数名や関数名の付け方（キャメルケースやスネークケース）とは対象が別で、ここでは扱いません。

書式を1行で決めたうえで、良い例と直したい例を20組、OSごとに使えない文字の一覧、そのまま貼れるフォルダ構成、既存ファイルを一括で改名するPythonコードまでを、動かした結果と一緒に載せます。

確認環境（確認日 2026-10-05）：Ubuntu 24.04（ext4）、bash 5.2、tree 2.1.1、Python 3.11。Windows と macOS の決まりは、今回開いた Microsoft Learn と Apple のユーザガイドの記載です（出典は末尾）。

この記事の結論

• 書式は YYYYMMDD_案件_文書名_vX.Y.拡張子 に固定する（例：20261005_備品管理_要件定義書_v0.1.docx）
• 日付は8桁の YYYYMMDD。区切りなし・ゼロ埋めにすると、名前順がそのまま日付順になる
• 版は v0.1（作成中）から始め、承認されたら v1.0。承認後の小さな直しは v1.1、承認を取り直す改訂は v2.0
• 「最新」「最終」「修正」は付けない。どれが新しいかは日付と版の数字で表す
• 区切りは半角アンダースコア、語の中のつなぎは半角ハイフン。空白と記号 \ / : * ? " < > | は使わない

命名規則の早見表

書式は1行で決める

YYYYMMDD_案件_文書名_vX.Y.拡張子

20261005_備品管理_要件定義書_v0.1.docx
│        │        │          │
│        │        │          └ 版：作成中は v0.x、承認済みは v1.0 以降
│        │        └ 文書名：文書の種類（一覧表の語を使う）
│        └ 案件：決めた呼び名を1つ
└ 日付：その版を保存した日（8桁）

順番を日付から始めるのは、フォルダを名前順に並べたときに時系列になるからです。 Pythonの sorted() で文字として並べ替えると、次のようになりました。

['2026-10-12_a', '2026-10-5_a', '20261005_a', '20261012_a', '5.10.2026_a', 'R8.10.5_a']

ゼロ埋めのない 2026-10-5 は 2026-10-12 より後ろに来ます。8桁の 20261005 と 20261012 は日付どおりの順です。日・月・年の順や元号の書き方は、年をまたぐと並びが崩れます。

日付に何の日を入れるかも1つに決めます。この記事では「その版を保存した日」とします。議事録だけは会議の開催日にすると探しやすくなります（文書名ごとの例外は一覧表に書いておきます）。

版番号の付け方（v0.1 から v1.0 へ）

版は「整数.整数」の2つの数字で表し、整数部が0なら作成中、1以上なら承認済みと読めるようにします。

版を上げるのは「人に渡すとき」です。自分の手元で保存するたびに上げる必要はありません。渡したあとに直すなら、同じ名前で上書きせず、小数部を1つ上げた別のファイルにします。相手の手元にある版と区別がつくからです。

小数部が2桁になる場合は、並び順に気を付けます。文字として並べ替えた結果は次のとおりでした。

['x_v0.10.docx', 'x_v0.2.docx', 'x_v0.9.docx', 'x_v1.0.docx']

v0.10 は v0.2 より前に並びます。この書式では日付が先頭にあるので、日付が違えば順番は保たれます。同じ日に v0.9 から v0.10 へ進むときだけ入れ替わります。作成中の版が10を超えそうな文書は、最初から v0.01 のように小数部を2桁にそろえておくと並びが崩れません。

良い例と直したい例 20組

右の列は、すべて 日付_案件_文書名_版 の4要素に機械的に分けられることをPythonの正規表現で確かめた名前です（20件すべて一致、最長36文字）。

入れない語と、その代わり

OSごとに使えない文字・予約名・長さ

Windows と macOS は公式ページの記載、Linux は ext4 上で実際にファイルを作って確かめた結果です。

「―」は、今回開いた公式ページにその記載が無かった項目です。

Linux で確かめたときの出力です（OK は作成できた、NG はエラーになった名前）。

OK  'a:b.txt'
OK  'a*b?.txt'
OK  'a<b>|".txt'
OK  'CON'
OK  'NUL.txt'
OK  'end. '
OK  'a\\b.txt'
NG  'a/b.txt' FileNotFoundError [Errno 2] No such file or directory: 'a/b.txt'
NG  'a\x00b' ValueError embedded null byte
OK  ascii255 255 bytes
NG  ascii256 256 bytes File name too long 36
OK  kana85 255 bytes
NG  kana86 258 bytes File name too long 36

$ getconf NAME_MAX .
255
$ getconf PATH_MAX .
4096

Linux では作れてしまう名前が、Windows では作れません。 共有フォルダやクラウドストレージを通して複数のOSから触るなら、いちばん制限の多い Windows の決まりに合わせておくと、どの環境でも同じ名前で扱えます。命名規則に「使う文字は全角かな漢字、半角英数字、_ - . のみ」と書いておけば、この表を毎回見なくても済みます。

パスの長さは、フォルダ名とファイル名の合計で決まります。Windows の260文字には、ドライブ名（C:\）から拡張子までの全部が入ります。フォルダを3階層までにして、ファイル名を50文字以内に収めると、共有フォルダの上位のパスが長くても余裕が残ります（50文字は例です。上位のパスの長さに合わせて決めます）。

フォルダ構成のテンプレート

フォルダは「番号_名前」にして、工程の順に並ぶようにします。 番号を2桁にそろえ、90_ 以降をひな形と保管に充てると、あとから工程を足しても並びが保たれます。

そのまま貼れるツリーです（tree -d -N の出力）。

bihin-kanri
├── 00_管理
│   ├── 01_計画
│   ├── 02_進捗報告
│   ├── 03_課題・リスク
│   └── 04_変更管理
├── 01_提案・契約
├── 02_要件定義
├── 03_設計
│   ├── 01_基本設計
│   └── 02_詳細設計
├── 04_開発
├── 05_試験
│   ├── 01_計画
│   ├── 02_仕様書
│   └── 03_結果
├── 06_移行・リリース
├── 07_運用・保守
├── 08_会議
│   ├── 01_定例
│   └── 02_レビュー
├── 09_受領資料
├── 90_ひな形
└── 99_保管

24 directories

mkdir -p で一括作成する

bash のブレース展開を使うと、1つのコマンドで全部のフォルダを作れます。先頭の bihin-kanri を自分の案件の名前に置き換えてください。

mkdir -p bihin-kanri/{00_管理/{01_計画,02_進捗報告,03_課題・リスク,04_変更管理},01_提案・契約,02_要件定義,03_設計/{01_基本設計,02_詳細設計},04_開発,05_試験/{01_計画,02_仕様書,03_結果},06_移行・リリース,07_運用・保守,08_会議/{01_定例,02_レビュー},09_受領資料,90_ひな形,99_保管}

mkdir -p は成功すると何も表示しません。作られた数を数えると、いちばん上の bihin-kanri を含めて24個でした。

$ find bihin-kanri -type d | wc -l
24
$ tree -d -N bihin-kanri | tail -n 1
24 directories

-p は途中のフォルダが無ければ一緒に作り、すでにあってもエラーにしないオプションです。同じコマンドをもう一度実行しても、中のファイルはそのまま残ります。

既存ファイルを一括で改名するPythonコード

すでにあるファイルを規則に合わせるコードです。標準ライブラリだけで動きます。最初は変更案を表示するだけで、--apply を付けたときに改名し、変更前後の対応表を残します。

決めていること：

• 日付は、名前に含まれていればそれを使い、無ければファイルの更新日を使う
• 版は、v1 ver2 第2版 があれば v1.0 v2.0 に直し、無ければ v0.1 にする
• 最新・最終・修正などの語、かっこ、Windows で使えない文字を取り除く
• 全角の英数字と全角の空白は半角にそろえる
• 改名後の名前が重なるときは、版の小数部を進めて重ならないようにする

#!/usr/bin/env python3
"""既存ファイルを「日付_案件_文書名_版.拡張子」にそろえる（Python 3.9 以降、標準ライブラリのみ）

使い方:
  python3 rename_files.py フォルダ 案件名            # 変更案を表示するだけ
  python3 rename_files.py フォルダ 案件名 --apply    # 実際に改名し、対応表 rename_log.tsv を残す
"""
import argparse
import csv
import datetime
import re
import unicodedata
from pathlib import Path

# 版を表さない飾りの語（見つけたら取り除く）
NOISE = ["最新版", "最終版", "最新", "最終", "修正版", "修正", "確定版", "確定",
         "コピー", "FIX", "fix", "new", "NEW", "old", "OLD"]
# Windows で使えない文字と制御文字
FORBIDDEN = re.compile(r'[<>:"/\|?*\x00-\x1f]')
# Windows の予約名
RESERVED = {"CON", "PRN", "AUX", "NUL",
            *(f"COM{i}" for i in range(1, 10)), *(f"LPT{i}" for i in range(1, 10))}
DONE = re.compile(r"^\d{8}_[^_]+_[^_]+_v\d+\.\d+$")          # すでに規則どおり
DATE = re.compile(r"(?<!\d)(20\d{2})[-_./]?(0[1-9]|1[0-2])[-_./]?(0[1-9]|[12]\d|3[01])(?!\d)")
VER = re.compile(r"(?i)(?:ver\.?|v|第)\s*(\d+)(?:\.(\d+))?版?")


def new_name(path: Path, project: str) -> str:
    stem = unicodedata.normalize("NFKC", path.stem)          # 全角英数・全角空白を半角に
    if DONE.match(stem):
        return path.name

    m = DATE.search(stem)                                     # 日付：名前にあればそれ、無ければ更新日
    if m:
        date = "".join(m.groups())
        stem = stem[:m.start()] + stem[m.end():]
    else:
        date = datetime.date.fromtimestamp(path.stat().st_mtime).strftime("%Y%m%d")

    m = VER.search(stem)                                      # 版：v2 → v2.0、無ければ v0.1
    if m:
        version = f"v{int(m.group(1))}.{int(m.group(2) or 0)}"
        stem = stem[:m.start()] + stem[m.end():]
    else:
        version = "v0.1"

    stem = stem.replace(project, "")
    for word in NOISE:
        stem = stem.replace(word, "")
    stem = re.sub(r"[()\[\]【】「」]", "", stem)                # かっこを外す
    stem = FORBIDDEN.sub("", stem)
    stem = re.sub(r"[\s_]+", "-", stem).strip("-. ")          # 空白と _ は - に（_ は区切り専用）
    stem = re.sub(r"-?\d+$", "", stem) or "文書"               # 「修正2」の残りの数字を落とす
    if stem.upper() in RESERVED:
        stem += "-文書"
    return f"{date}_{project}_{stem}_{version}{path.suffix.lower()}"


def main() -> None:
    ap = argparse.ArgumentParser()
    ap.add_argument("folder", type=Path)
    ap.add_argument("project")
    ap.add_argument("--apply", action="store_true")
    args = ap.parse_args()

    files = sorted(p for p in args.folder.iterdir()
                   if p.is_file() and p.name != "rename_log.tsv")
    plan, taken = [], {p.name for p in files}
    for p in files:
        name = new_name(p, args.project)
        if name != p.name:
            base, n = name, 1
            while name in taken:                              # 同じ名前になるときは版の小数を進める
                n += 1
                name = re.sub(r"_v(\d+)\.\d+(\.[^.]+)$", rf"_v\1.{n}\2", base)
            taken.add(name)
        plan.append((p, name))

    for p, name in plan:
        mark = "そのまま" if p.name == name else "改名   "
        print(f"{mark}  {p.name}\n      -> {name}")
    changed = [(p, n) for p, n in plan if p.name != n]
    print(f"\n対象 {len(plan)} 件 / 改名 {len(changed)} 件 / そのまま {len(plan) - len(changed)} 件")

    if not args.apply:
        print("（表示のみ。--apply を付けると改名します）")
        return
    with open(args.folder / "rename_log.tsv", "w", newline="", encoding="utf-8") as f:
        w = csv.writer(f, delimiter="\t")
        w.writerow(["変更前", "変更後"])
        for p, name in changed:
            p.rename(p.with_name(name))
            w.writerow([p.name, name])
    print("改名しました。対応表: rename_log.tsv")


if __name__ == "__main__":
    main()

実行結果

9個のファイルを置いたフォルダ r で試しました。

$ ls -1 r
20260930_備品管理_試験計画書_v0.3.docx
メモ.txt
基本設計書 ver2.xlsx
画面一覧_v1.xlsx
要件定義書_修正2.docx
要件定義書（最終）.docx
見積:概算?.xlsx
議事録最新.docx
進捗報告_ＦＩＸ　10月.pptx

$ python3 rename_files.py r 備品管理
そのまま  20260930_備品管理_試験計画書_v0.3.docx
      -> 20260930_備品管理_試験計画書_v0.3.docx
改名     メモ.txt
      -> 20261002_備品管理_メモ_v0.1.txt
改名     基本設計書 ver2.xlsx
      -> 20260925_備品管理_基本設計書_v2.0.xlsx
改名     画面一覧_v1.xlsx
      -> 20260926_備品管理_画面一覧_v1.0.xlsx
改名     要件定義書_修正2.docx
      -> 20260918_備品管理_要件定義書_v0.1.docx
改名     要件定義書（最終）.docx
      -> 20260912_備品管理_要件定義書_v0.1.docx
改名     見積:概算?.xlsx
      -> 20261001_備品管理_見積概算_v0.1.xlsx
改名     議事録最新.docx
      -> 20260901_備品管理_議事録_v0.1.docx
改名     進捗報告_ＦＩＸ　10月.pptx
      -> 20261003_備品管理_進捗報告-10月_v0.1.pptx

対象 9 件 / 改名 8 件 / そのまま 1 件
（表示のみ。--apply を付けると改名します）

--apply を付けて実行したあとのフォルダと対応表です。

$ python3 rename_files.py r 備品管理 --apply
…（省略）…
対象 9 件 / 改名 8 件 / そのまま 1 件
改名しました。対応表: rename_log.tsv
$ ls -1 r
20260901_備品管理_議事録_v0.1.docx
20260912_備品管理_要件定義書_v0.1.docx
20260918_備品管理_要件定義書_v0.1.docx
20260925_備品管理_基本設計書_v2.0.xlsx
20260926_備品管理_画面一覧_v1.0.xlsx
20260930_備品管理_試験計画書_v0.3.docx
20261001_備品管理_見積概算_v0.1.xlsx
20261002_備品管理_メモ_v0.1.txt
20261003_備品管理_進捗報告-10月_v0.1.pptx
rename_log.tsv

もう一度実行すると「改名 0 件 / そのまま 9 件」になり、規則どおりの名前には手を加えないことを確かめました。

結果を見て手で直すところ

コードが決められるのは形だけです。次の2点は人が見て直します。

• 版の数字：要件定義書（最終） と 要件定義書_修正2 は、どちらも版の数字を持たないので v0.1 になりました。日付が違うため名前は重なりませんが、承認済みのものは v1.0 に、その後の直しは v1.1 に手で上げます。
• 日付：名前に日付が無いファイルは更新日を使います。コピーやダウンロードで更新日が変わっている場合は、対応表を見ながら直します。

改名の前にフォルダごと複製を取っておくと、安心して試せます。対応表 rename_log.tsv は、ほかの文書からの参照を直すときの手がかりにもなります。

ファイル名の版・Git・クラウドストレージの版履歴の違い

版を残す方法は3つあり、向いている対象が違います。

どれを使うかの判断基準

1つの文書に2つの方法を重ねないのが基本です。 Git で管理しているファイルに _v2 を付けると、履歴が別のファイルに分かれてしまいます。

確かめて分かったこと

• Linux では : * ? < > | " を含む名前や CON NUL.txt を作成できました。 作れた名前が Windows へ持っていけるとは限らないため、命名規則は制限の多い側に合わせて書きます。
• Linux の名前の上限は「文字」ではなく「バイト」でした。 半角は255文字まで作れましたが、かなは85文字（255バイト）までで、86文字（258バイト）は File name too long になりました。
• v0.10 は文字として並べると v0.2 より前に来ました。 日付を先頭に置く書式なら、同じ日のうちに小数部が10に届く場合を除いて順番は保たれます。
• ゼロ埋めのない日付 2026-10-5 は 2026-10-12 より後ろに並びました。 8桁にそろえる理由はこの1点です。
• 一括改名のコードは、版の数字を持たないファイルをすべて v0.1 にします。 「最終」と書かれたファイルを v1.0 にするかどうかは、承認の記録を見て人が決めます。
• mkdir -p は2回実行してもエラーにならず、既存のフォルダと中身を残しました。 フォルダを足したいときは、同じコマンドに追記して流し直せます。

よくある質問

Q. ファイル名の命名規則とは何ですか？ A. ファイルの名前に入れる要素と順番、使う文字を決めた取り決めです。この記事では「日付_案件_文書名_版」の4要素を、半角アンダースコアで区切る形にしています。

Q. ファイル名に日付と版の両方を入れるのはなぜですか？ A. 役割が違うからです。日付は「いつの時点のものか」と並び順を、版は「作成中か承認済みか」を表します。同じ日に2回渡すこともあれば、日付が変わっても版を上げない保存もあります。

Q. ファイル名に「最新」「最終」を付けないほうがよいのはなぜですか？ A. 次の版ができた時点で、名前と中身が合わなくなるからです。新しさは日付と版の数字で表し、以前の版は 99_保管 へ移します。

Q. ファイル名を英数字だけにする必要はありますか？ A. 文書ファイルなら日本語で問題ありません。Windows で使えない記号と空白を避ければ、3つのOSで同じ名前を使えます。URLの一部になるファイルや、コマンドで頻繁に扱うファイルは、半角英数字にしておくと入力が楽になります。

Q. 長いファイル名でコピーできないときはどうすればよいですか？ A. フォルダの階層を浅くするか、フォルダ名とファイル名を短くします。Windows ではパス全体が260文字までという決まりがあり、ファイル名だけでなく上位のフォルダ名の長さも合計に入ります。

まとめ

• 書式は YYYYMMDD_案件_文書名_vX.Y.拡張子 の1行に固定する
• 日付は8桁、版は v0.1 から始めて承認で v1.0。承認後の小さな直しは v1.1、承認を取り直したら v2.0
• 最新・最終・修正・コピーは付けない。新しさは数字で表し、以前の版は保管用フォルダへ
• 使う文字は、全角かな漢字・半角英数字・_ - . に絞る。Windows の決まりに合わせれば macOS と Linux でも通る
• フォルダは「2桁の番号_名前」で工程順に並べ、mkdir -p で一括作成する
• 既存ファイルはコードで形をそろえ、版の数字と日付は対応表を見て人が仕上げる
• ソースコードは Git、相手に渡す文書はファイル名の版、同時編集の下書きはクラウドの版履歴と使い分ける

参考・出典

• Microsoft Learn「Naming Files, Paths, and Namespaces」 https://learn.microsoft.com/en-us/windows/win32/fileio/naming-a-file （2026-10-05 確認）
• Microsoft Learn「Maximum Path Length Limitation」 https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation （2026-10-05 確認）
• Apple「Macでファイル、フォルダ、ディスクの名前を変更する」（macOS Tahoe 26 のユーザガイド） https://support.apple.com/ja-jp/guide/mac-help/mchlp1144/mac （2026-10-05 確認）

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。