Word VBAの「Find」を支配せよ：MatchCaseの罠と、壊れない置換エンジンの設計論
Word VBAにおけるテキスト処理は、一見するとシンプルだ。`Range.Find`メソッドを呼び出し、`Replacement.Text`をセットして実行する。しかし、多くのプログラマーがここで躓く。特に「大文字・小文字の区別（MatchCase）」という、極めて初歩的かつ凶悪な仕様に足元をすくわれるのだ。
今日は、場当たり的なスクリプトを卒業し、「意図せぬ置換」を根絶するための堅牢な設計手法を伝授する。
—
1. なぜ「MatchCase」はエンジニアを裏切るのか
`Find.MatchCase`プロパティは、Boolean型で真偽を切り替える。しかし、このプロパティを「その場しのぎ」で設定すると、次のような悲劇が起きる。
- 状態の汚染: Wordの検索設定は、アプリケーションの状態として永続化されることがある。前回の検索設定が、現在のロジックに予期せぬ形で持ち越されるのだ。
- デフォルトの暴力: コード内で明示的に`MatchCase = False`としても、ユーザーがWordの検索画面で「大文字と小文字を区別する」にチェックを入れた状態で保存したドキュメントを開くと、予期せぬ挙動を示すケースがある。
極意: 「設定は常に明示的かつ局所的に行い、処理終了後に必ずリセットする」こと。これがプロダクション・コードの鉄則だ。
—
2. 堅牢な置換エンジンの設計パターン
単にコードを書くのではなく、「再利用可能で、副作用のない関数」としてカプセル化する。以下は、私がプロジェクトで採用している標準的なテンプレートだ。
‘ @brief 堅牢な文字列置換を実行するプロシージャ
‘ @param targetRange 置換対象となるRangeオブジェクト
‘ @param findText 検索文字列
‘ @param replaceText 置換後の文字列
‘ @param matchCase 大文字・小文字を区別するかどうか
Public Sub SafeReplace(ByRef targetRange As Range, _
ByVal findText As String, _
ByVal replaceText As String, _
Optional ByVal matchCase As Boolean = True)
‘ Findオブジェクトのステートをクリーンアップ
With targetRange.Find
.ClearFormatting
.Replacement.ClearFormatting
‘ 検索パラメータの厳格な設定
.Text = findText
.Replacement.Text = replaceText
.Forward = True
.Wrap = wdFindContinue
.Format = False
.MatchCase = matchCase ‘ ここが極めて重要
.MatchWholeWord = False
.MatchByte = False
.MatchWildcards = False ‘ 正規表現を使う場合は別途設計が必要
.MatchSoundsLike = False
.MatchAllWordForms = False
‘ 置換実行（全置換）
.Execute Replace:=wdReplaceAll
End With
‘ 重要: 検索状態をリセットし、メモリ上の残留設定を排除する
targetRange.Find.ClearFormatting
End Sub
このコードが「伝説」たる所以
1. ClearFormattingの徹底: 設定の衝突を防ぐ。前後の処理で書式条件が汚染されることを物理的に遮断する。
2. Optional引数の活用: デフォルトを`True`（厳格な区別）に設定。あえて「誤変換」の可能性を減らす設計思想だ。
3. Rangeの局所化: `ActiveDocument.Content`を直接操作せず、引数として`Range`を渡すことで、特定の章や選択範囲のみを対象とする柔軟性を確保している。
—
3. 正規表現（Regex）という「魔術」の取り扱い
もし「大文字・小文字を区別しつつ、特定のパターンを置換したい」という要件なら、`Find.MatchWildcards`に頼るべきではない。Word標準のワイルドカードは限定的であり、複雑な処理には不向きだ。
解決策:
VBAの標準機能で完結させたい場合、`Microsoft VBScript Regular Expressions 5.5`を参照設定し、メモリ上で置換処理を行い、その結果をWordのテキストに流し込むのが、最もパフォーマンスが良く、バグを抑えられる。
- データ連携の注意点: データベースや外部ファイル（JSON/CSV）から置換リストを読み込む際は、必ず「文字コード」と「改行コード」を確認すること。VBAの`String`型はUTF-16で処理されるため、ソース側との不一致は致命的な文字化けを招く。
—
4. 最後に：エンジニアとしてのマインドセット
自動化ツールは「作った時」がゴールではない。「修正が必要になった時」や「仕様変更が来た時」に、どれだけメンテナンスコストを抑えられるかが腕の見せ所だ。
今回紹介したコードは、一見冗長に見えるかもしれない。しかし、「なぜここでリセットが必要なのか」「なぜこの設定がデフォルトなのか」という意図がコードに残っていることこそが、チーム開発において最も価値のある資産となる。
明日から、君のコードに「必然性」を宿らせてほしい。Word VBAの奥底にある挙動を掌握した時、ドキュメント生成はただの作業から「アーキテクチャ」へと昇華されるはずだ。
