昨日まで動いていたマクロが、今日はエラーで止まった。原因を調べたら、誰かがシート名を「集計」から「集計表」に変えていた。
VBAのマクロは、対象が存在することを前提に書かれていることがほとんどです。そのため、シート名の変更やファイルの移動といった小さな変化で簡単に止まります。
この記事では、処理の前に「あるかどうか」を確認する書き方をまとめます。
シートが存在するか調べる
最も使用頻度が高いチェックです。汎用の関数として用意しておくと、どのマクロからも呼び出せます。
' シートが存在すれば True を返す Function SheetExists(ByVal sheetName As String, _ Optional ByVal wb As Workbook) As Boolean Dim ws As Worksheet If wb Is Nothing Then Set wb = ThisWorkbook For Each ws In wb.Worksheets If ws.Name = sheetName Then SheetExists = True Exit Function End If Next ws SheetExists = False End Function
使い方は次の通りです。
Sub UseSheetExists() If Not SheetExists("集計") Then MsgBox "「集計」シートが見つかりません。" & vbCrLf & _ "シート名を確認してください。", vbExclamation Exit Sub End If ' ここから本来の処理 ThisWorkbook.Worksheets("集計").Range("A1").Value = "開始" End Sub
全シートを1つずつ照合する方式なので、エラー処理に頼らず確実に判定できます。第2引数を省略すると、マクロが書かれているブックを対象にします。
無ければ作る
チェックと作成をまとめておくと便利です。
' シートを取得する。存在しなければ新規作成して返す Function GetOrCreateSheet(ByVal sheetName As String) As Worksheet If SheetExists(sheetName) Then Set GetOrCreateSheet = ThisWorkbook.Worksheets(sheetName) Else Dim ws As Worksheet Set ws = ThisWorkbook.Worksheets.Add( _ After:=ThisWorkbook.Worksheets(ThisWorkbook.Worksheets.Count)) ws.Name = sheetName Set GetOrCreateSheet = ws End If End Function
Sub UseGetOrCreate() Dim ws As Worksheet Set ws = GetOrCreateSheet("出力結果") ws.Cells.Clear ws.Range("A1").Value = "出力日時: " & Now End Sub
出力先シートを毎回作る処理では、この形がよく使われます。
On Error Resume Next を使った書き方
より短く書く方法もあります。
Function SheetExists2(ByVal sheetName As String) As Boolean Dim ws As Worksheet On Error Resume Next Set ws = ThisWorkbook.Worksheets(sheetName) On Error GoTo 0 ' すぐに解除する SheetExists2 = Not ws Is Nothing End Function
存在しないシートを指定するとエラーになる性質を利用し、エラーを無視して結果を見る方式です。
注意点は、On Error GoTo 0 で必ず元に戻すことです。 On Error Resume Next を書いたままにすると、そのプロシージャ内のすべてのエラーが無視されます。本来止まるべき不具合まで素通りしてしまい、原因の分からない誤動作につながります。
エラー無視は「1行だけ挟んで、すぐ解除する」という使い方に限定してください。
ファイル・フォルダの存在を調べる
Dir 関数を使います。
' ファイルが存在すれば True Function FileExists(ByVal filePath As String) As Boolean If Len(Trim(filePath)) = 0 Then Exit Function FileExists = (Dir(filePath, vbNormal) <> "") End Function ' フォルダが存在すれば True Function FolderExists(ByVal folderPath As String) As Boolean If Len(Trim(folderPath)) = 0 Then Exit Function FolderExists = (Dir(folderPath, vbDirectory) <> "") End Function
vbDirectory を指定しないとフォルダは判定できません。ここを間違えると、フォルダがあるのに「無い」と判定されます。
FileSystemObject を使う方法もあります。読みやすさを優先するならこちらです。
Function FileExistsFSO(ByVal filePath As String) As Boolean Dim fso As Object Set fso = CreateObject("Scripting.FileSystemObject") FileExistsFSO = fso.FileExists(filePath) End Function Function FolderExistsFSO(ByVal folderPath As String) As Boolean Dim fso As Object Set fso = CreateObject("Scripting.FileSystemObject") FolderExistsFSO = fso.FolderExists(folderPath) End Function
無ければフォルダを作る
途中の階層も含めてまとめて作成する例です。
Sub CreateFolderDeep(ByVal folderPath As String) Dim fso As Object Set fso = CreateObject("Scripting.FileSystemObject") If fso.FolderExists(folderPath) Then Exit Sub ' 親フォルダが無ければ先に作る(再帰) Dim parent As String parent = fso.GetParentFolderName(folderPath) If Len(parent) > 0 Then If Not fso.FolderExists(parent) Then CreateFolderDeep parent End If fso.CreateFolder folderPath End Sub
MkDir は途中の階層が無いとエラーになりますが、この書き方なら C:\出力\2026\09 のような深い階層を一度に作れます。
ブックが開いているか調べる
すでに開いているブックを再度開こうとすると、警告が出たり編集内容が失われたりします。
' 指定した名前のブックが開いていれば True Function IsBookOpen(ByVal bookName As String) As Boolean Dim wb As Workbook For Each wb In Application.Workbooks If StrComp(wb.Name, bookName, vbTextCompare) = 0 Then IsBookOpen = True Exit Function End If Next wb IsBookOpen = False End Function
StrComp に vbTextCompare を指定すると、大文字小文字を区別せずに比較します。Windowsのファイル名は大文字小文字を区別しないため、この指定が適切です。
開いていれば使い、閉じていれば開く
Function GetWorkbook(ByVal filePath As String) As Workbook Dim fileName As String fileName = Dir(filePath) If fileName = "" Then MsgBox "ファイルが見つかりません:" & vbCrLf & filePath, vbExclamation Exit Function End If If IsBookOpen(fileName) Then Set GetWorkbook = Application.Workbooks(fileName) Else Set GetWorkbook = Application.Workbooks.Open(filePath) End If End Function
別のフォルダにある同名ファイルが開いている場合、名前だけの判定では誤って別のブックを掴みます。厳密に判定するなら、フルパスで比較します。
Function IsBookOpenByPath(ByVal fullPath As String) As Boolean Dim wb As Workbook For Each wb In Application.Workbooks If StrComp(wb.FullName, fullPath, vbTextCompare) = 0 Then IsBookOpenByPath = True Exit Function End If Next wb End Function
その他のチェック
名前の定義が存在するか
Function NameExists(ByVal nameStr As String) As Boolean Dim nm As Name For Each nm In ThisWorkbook.Names If nm.Name = nameStr Then NameExists = True Exit Function End If Next nm End Function
セルに値が入っているか
Sub CheckCells() ' 空白かどうか If IsEmpty(Range("A1").Value) Then MsgBox "A1が未入力です" End If ' 数値かどうか If Not IsNumeric(Range("B1").Value) Then MsgBox "B1が数値ではありません" End If ' エラー値かどうか If IsError(Range("C1").Value) Then MsgBox "C1がエラーになっています" End If ' 範囲内にデータがあるか If WorksheetFunction.CountA(Range("A1:A1000")) = 0 Then MsgBox "データがありません" End If End Sub
テーブル(ListObject)が存在するか
Function TableExists(ByVal ws As Worksheet, ByVal tableName As String) As Boolean Dim lo As ListObject For Each lo In ws.ListObjects If lo.Name = tableName Then TableExists = True Exit Function End If Next lo End Function
実行前にまとめて確認する
処理の途中で止まると、中途半端な状態のデータが残ります。必要な条件は、処理を始める前にまとめて確認するのが安全です。
Sub MainProcess() Dim errMsg As String ' --- 事前チェック --- If Not SheetExists("入力") Then errMsg = errMsg & "・「入力」シートがありません" & vbCrLf End If If Not SheetExists("マスタ") Then errMsg = errMsg & "・「マスタ」シートがありません" & vbCrLf End If If Not FolderExists("C:\出力") Then errMsg = errMsg & "・出力先フォルダ C:\出力 がありません" & vbCrLf End If If SheetExists("入力") Then If WorksheetFunction.CountA(Worksheets("入力").Range("A2:A10000")) = 0 Then errMsg = errMsg & "・「入力」シートにデータがありません" & vbCrLf End If End If ' --- 1件でも問題があれば中止する --- If Len(errMsg) > 0 Then MsgBox "処理を開始できません。" & vbCrLf & vbCrLf & errMsg, vbExclamation Exit Sub End If ' --- ここから本処理 --- Call ExecuteMain End Sub
問題を1つずつではなくまとめて提示するのがポイントです。「シートがありません」と直したら次は「フォルダがありません」と出る、という往復を避けられます。
まとめ
- シートの存在確認は、全シートを照合する関数を1つ作って使い回す
On Error Resume Nextは1行だけ挟み、On Error GoTo 0ですぐ解除する- フォルダの判定には
Dir(パス, vbDirectory)を使う - ブックが開いているかは、名前ではなくフルパスで比較すると確実
- 必要な条件は処理前にまとめて確認し、問題があれば一覧で伝える
「エラーが出たら直す」ではなく「エラーになる前に止める」形にしておくと、自分以外の人に渡すマクロとして安心して使えるようになります。
他の記事でもExcel VBAの実務的なテクニックを紹介していますので、ぜひチェックしてみてください。