VBScriptを掌握せよ：FSOのBuildPathで実現する「パス結合の絶対正義」
現場で自動化ツールを組んでいると、必ず遭遇する「パス連結の罠」がある。
「`Folder & “\” & FileName`」と手動で文字列を連結していないだろうか？
もし君がまだその書き方をしているなら、今すぐ止めるべきだ。それは「動けばいい」という未熟な発想であり、将来のバグの温床でしかない。本稿では、VBScriptにおけるファイル操作の鉄則、`FileSystemObject (FSO)` の `BuildPath` メソッドを用いた、堅牢かつプロフェッショナルなパス構築技術を伝授する。
—
1. なぜ「手動連結」は死を招くのか
初心者がやりがちな以下のコードを見てほしい。
‘ 最悪の例：ハードコーディングされた連結
Dim path : path = folderPath & “\” & fileName
この書き方には、致命的な欠陥が3つある。
1. セパレータの重複リスク: `folderPath` の末尾に既に `\` が含まれている場合、`\\` という不正なパスが生成される。
2. 可読性の欠如: コードのあちこちに文字列操作が散らばり、保守性が著しく低下する。
3. OS非依存性の欠如: VBScriptが動作する環境において、パス区切り文字の管理をプログラマが背負うのは、本来不要なコストである。
業務自動化ツールは、一度構築すれば数年にわたって運用されるものだ。「動いたから良し」ではなく、「なぜ壊れないのか」を設計段階で担保せねばならない。
—
2. BuildPathメソッド：プロの選択
`FileSystemObject` には、我々が頭を悩ませるパス連結問題を一発で解決する `BuildPath` メソッドが用意されている。
‘ 正しい書き方：BuildPathの使用
Set fso = CreateObject(“Scripting.FileSystemObject”)
fullPath = fso.BuildPath(folderPath, fileName)
`BuildPath` は、第一引数と第二引数の間に、必要であれば適切な区切り文字（`\`）を挿入してくれる。既にパスが正しく整っていれば、余計な区切り文字を追加することはない。この「状態を自動判断する」という挙動こそ、バグを排除するための「防衛的プログラミング」の基本である。
—
3. 実践：保守性の高いプロダクションコード
現場でそのまま使える、堅牢なファイル操作のテンプレートを用意した。エラーハンドリングを含め、オブジェクトの解放までを意識したコードだ。
Option Explicit
‘ メイン処理：安全にパスを構築してファイルを生成する
Sub CreateReportFile(folderPath, fileName)
Dim fso, fullPath, fileStream
‘ オブジェクト生成（リソースの最小化）
Set fso = CreateObject(“Scripting.FileSystemObject”)
‘ BuildPathで安全にパスを合成
fullPath = fso.BuildPath(folderPath, fileName)
‘ パス構築後の安全確認（存在確認などもここで行う）
On Error Resume Next
Set fileStream = fso.CreateTextFile(fullPath, True)
If Err.Number <> 0 Then
WScript.Echo “致命的なエラー: パスを作成できませんでした – ” & fullPath
Else
fileStream.WriteLine “ログ記録開始: ” & Now
fileStream.Close
WScript.Echo “成功: ” & fullPath
End If
On Error GoTo 0
‘ オブジェクトの解放（メモリリーク防止）
Set fileStream = Nothing
Set fso = Nothing
End Sub
‘ 実行例
Call CreateReportFile(“C:\Work”, “output.txt”)
このコードのポイント
- `Option Explicit`: 変数の宣言を強制し、タイポによる予期せぬバグを未然に防ぐ。
- `On Error Resume Next`: ファイルシステム操作は、権限や競合で必ずエラーが発生するリスクがある。これを握りつぶすのではなく、`Err.Number` で制御する。
- リソース管理: `Set = Nothing` は、VBScriptのライフサイクルを考慮する上で必須の作法だ。
—
4. チーフアーキテクトからの助言
「自動化ツール」とは、単に作業を代行するだけのスクリプトではない。「人間が手作業で行う際の曖昧さを、論理的に排除するシステム」のことだ。
パスの連結のような些細な部分に、そのエンジニアの「品質に対する意識」が表れる。`BuildPath` を使うことは、単なるメソッドの利用ではなく、「私はパス管理という不確実な要素を、ライブラリの規約に従って管理する」というエンジニアとしての意思表明である。
次は、この `BuildPath` を軸にして、フォルダの自動作成や一括リネームなど、より高度なファイルシステム操作へと進んでほしい。VBScriptは古いが、その本質的な設計思想は、現代のどの言語にも通じるものだ。
さあ、君のコードから `& “\”` を撲滅しよう。それが、プロへの第一歩だ。
