完成イメージと準備するもの

「ローカル設定」シートにクローンのフォルダーを入れてボタンを押すと、「コミット履歴(ローカル)」シートに、日時・作者・SHA・メッセージ・ファイル数・追加・削除の一覧が展開される。PART 06 とシート名を分けてあるので、同じブックに両方のマクロを入れてもよい。

もの用途
Excel(Windows 版)マクロの実行
Git for Windowsgit コマンド。コマンドプロンプトで git --version が動く状態にしておく
対象リポジトリのクローン履歴の取得元

VBA-JSON も参照設定も要らない。使うのは Windows に標準で入っている WScript.Shell・ADODB.Stream・Scripting.FileSystemObject だけだ。クローンがまだなければ、ターミナルで作っておく(オプションの意味は PART 05 を参照)。

ターミナル
git clone https://github.com/VBA-tools/VBA-JSON.git C:\work\VBA-JSON

VBA から Git を実行する方法

VBA から外部のコマンドを実行する方法はいくつかある。結果を受け取る必要があるので、「終了を待てること」と「出力を正しく読めること」が条件になる。

方法終了を待つ出力の受け取り評価
VBA の Shell 関数× 待たない(Windows API の宣言が必要)×向かない
WScript.Shell の Exec△ 自分でループして待つStdOut から読めるが、日本語が化ける。黒い画面が一瞬出る英数字だけなら使える
WScript.Shell の Run + 一時ファイル○ 引数で指定できるGit にファイルへ書き出させ、UTF-8 として読むこの回で使う

Exec の StdOut で日本語が化けるのは、Git が UTF-8 で出力した内容を、Windows の既定の文字コード(CP932)として読んでしまうからだ。コミットメッセージや作者名に日本語が含まれると、正しく取り込めない。

そこで、git log の --output=ファイル オプションを使う。これは結果を画面ではなくファイルに書き出すオプションで、リダイレクト(>)と違って cmd.exe を経由する必要がない。書き出されたファイルを ADODB.Stream で UTF-8 として読めば、文字化けは起きない。

ブックを準備する

  1. マクロ有効ブック(.xlsm)に 「ローカル設定」 という名前のシートを作り、下の表のとおりに入力する
  2. Alt+F11 で VBE を開き、「挿入」→「標準モジュール」 で新しいモジュールを追加して、名前を GitLocalCommits にする
セルA 列(見出し)B 列(値)省略したとき
1行目クローンのフォルダーC:\work\VBA-JSON省略不可
2行目起点(例:origin/HEAD、origin/main)HEAD(手元のブランチ)
3行目最大件数(例:300)全件
4行目変更行数も取得TRUE または FALSE取得しない
5行目先に fetch するTRUE または FALSEfetch しない

「起点」の考え方は PART 05 と同じだ。自分が作業しているブランチの履歴(未プッシュ分を含む)を見たいなら空欄のまま、GitHub 上の最新の履歴を見たいなら、B5 を TRUE にして起点を origin/HEAD や origin/main にする。

マクロ全体

標準モジュール GitLocalCommits に次のコードを貼り付ける。

VBA(標準モジュール GitLocalCommits)
Option Explicit
'
' ローカルクローンに git log を実行して「コミット履歴(ローカル)」シートに展開する
' 必要なもの:Git for Windows(git に PATH が通っていること)
'
Private Const MARK As String = "@@"            ' コミットの行の先頭に付ける目印

' ===== エントリーポイント(ボタンに登録する) =====
Public Sub ローカルのコミット履歴を取得()
    Dim ws As Worksheet, repoDir As String, rev As String
    Dim maxCount As Long, withStats As Boolean, doFetch As Boolean
    Dim tmpFile As String, args As String, logText As String, n As Long

    On Error GoTo Failed
    Application.ScreenUpdating = False

    ' ① 設定を読む
    Set ws = ThisWorkbook.Worksheets("ローカル設定")
    repoDir = Trim$(ws.Range("B1").Value)
    If Not CreateObject("Scripting.FileSystemObject").FolderExists(repoDir & "\.git") Then
        Err.Raise vbObjectError + 1, , "B1 のフォルダーに .git がありません。クローンしたフォルダーを指定してください。"
    End If
    rev = Trim$(ws.Range("B2").Value)
    If rev = "" Then rev = "HEAD"
    maxCount = Val(ws.Range("B3").Value)
    withStats = IsTrue(ws.Range("B4").Value)
    doFetch = IsTrue(ws.Range("B5").Value)

    ' ② 必要なら最新の履歴を取り込む(認証を求められたときに見えるよう、ウィンドウを表示する)
    If doFetch Then
        Application.StatusBar = "git fetch を実行中…"
        RunGit repoDir, "fetch --prune", 1
    End If

    ' ③ git log の結果を一時ファイルに書き出す
    tmpFile = Environ$("TEMP") & "\gitlog_" & Format$(Now, "yyyymmdd_hhnnss") & ".txt"
    args = "-c i18n.logOutputEncoding=UTF-8 -c core.quotepath=false log" & _
           " --output=" & Quote(tmpFile) & _
           " " & Quote("--date=format-local:%Y-%m-%d %H:%M:%S") & _
           " " & Quote("--pretty=format:" & MARK & "%H%x09%an%x09%ad%x09%s")
    If withStats Then args = args & " --numstat"
    If maxCount > 0 Then args = args & " --max-count=" & maxCount
    args = args & " " & Quote(rev) & " --"
    Application.StatusBar = "git log を実行中…"
    RunGit repoDir, args, 0

    ' ④ UTF-8 として読み込み、シートに展開する
    logText = ReadUtf8File(tmpFile)
    Kill tmpFile
    n = WriteCommits(logText, withStats)

    Application.StatusBar = False
    Application.ScreenUpdating = True
    MsgBox n & " 件のコミットを取得しました。", vbInformation
    Exit Sub

Failed:
    Application.StatusBar = False
    Application.ScreenUpdating = True
    MsgBox "取得に失敗しました。" & vbCrLf & Err.Description, vbExclamation
End Sub

' ===== git を実行して終了を待つ =====
Private Sub RunGit(ByVal repoDir As String, ByVal args As String, ByVal windowStyle As Long)
    Dim sh As Object, cmd As String, rc As Long
    Set sh = CreateObject("WScript.Shell")
    cmd = "git -C " & Quote(repoDir) & " " & args
    Debug.Print cmd                                    ' 確認用:イミディエイト ウィンドウに表示
    rc = sh.Run(cmd, windowStyle, True)                ' 0 = 非表示、1 = 表示 / True = 終了を待つ
    If rc <> 0 Then
        Err.Raise vbObjectError + 2, , "git がエラーで終了しました(終了コード " & rc & ")。" & vbCrLf & _
            "イミディエイト ウィンドウに表示されたコマンドをターミナルで実行し、エラーの内容を確認してください。"
    End If
End Sub

' ===== 「コミット履歴(ローカル)」シート:書き込んだ件数を返す =====
Private Function WriteCommits(ByVal logText As String, ByVal withStats As Boolean) As Long
    Dim ws As Worksheet, lines() As String, data() As Variant
    Dim f() As String, ln As String, i As Long, n As Long, r As Long

    lines = Split(Replace(logText, vbCr, ""), vbLf)
    For i = 0 To UBound(lines)
        If Left$(lines(i), Len(MARK)) = MARK Then n = n + 1
    Next

    Set ws = PrepareSheet("コミット履歴(ローカル)")
    ReDim data(1 To n + 1, 1 To 7)
    data(1, 1) = "日時": data(1, 2) = "作者": data(1, 3) = "SHA": data(1, 4) = "メッセージ"
    data(1, 5) = "ファイル数": data(1, 6) = "追加": data(1, 7) = "削除"

    r = 1
    For i = 0 To UBound(lines)
        ln = lines(i)
        If Left$(ln, Len(MARK)) = MARK Then
            ' コミットの行:@@SHA<TAB>作者<TAB>日時<TAB>メッセージの1行目
            f = Split(Mid$(ln, Len(MARK) + 1), vbTab, 4)
            If UBound(f) = 3 Then
                r = r + 1
                data(r, 1) = CDate(f(2))
                data(r, 2) = f(1)
                data(r, 3) = Left$(f(0), 7)
                data(r, 4) = f(3)
                If withStats Then data(r, 5) = 0: data(r, 6) = 0: data(r, 7) = 0
            End If
        ElseIf withStats And r > 1 And ln <> "" Then
            ' --numstat の行:追加<TAB>削除<TAB>パス(バイナリファイルは - になる)
            f = Split(ln, vbTab, 3)
            If UBound(f) = 2 Then
                data(r, 5) = data(r, 5) + 1
                If f(0) <> "-" Then
                    data(r, 6) = data(r, 6) + CLng(f(0))
                    data(r, 7) = data(r, 7) + CLng(f(1))
                End If
            End If
        End If
    Next

    ws.Range("B:D").NumberFormat = "@"             ' SHA やメッセージを数値・数式にしない
    ws.Range("A1").Resize(r, 7).Value = data
    ws.Columns(1).NumberFormat = "yyyy/mm/dd hh:mm"
    ws.Range("A1").Resize(1, 7).Font.Bold = True
    ws.Range("A1").Resize(r, 7).AutoFilter
    ws.Columns("A:G").AutoFit
    If ws.Columns(4).ColumnWidth > 60 Then ws.Columns(4).ColumnWidth = 60
    WriteCommits = r - 1
End Function

' ===== 小さな関数 =====
Private Function Quote(ByVal s As String) As String
    Quote = """" & s & """"
End Function

Private Function IsTrue(ByVal v As Variant) As Boolean
    IsTrue = (UCase$(Trim$(CStr(v))) = "TRUE")
End Function

Private Function ReadUtf8File(ByVal path As String) As String
    Dim st As Object
    Set st = CreateObject("ADODB.Stream")
    st.Type = 2: st.Charset = "utf-8": st.Open      ' 2 = テキスト
    st.LoadFromFile path
    ReadUtf8File = st.ReadText
    st.Close
End Function

Private Function PrepareSheet(ByVal sheetName As String) As Worksheet
    On Error Resume Next
    Set PrepareSheet = ThisWorkbook.Worksheets(sheetName)
    On Error GoTo 0
    If PrepareSheet Is Nothing Then
        Set PrepareSheet = ThisWorkbook.Worksheets.Add(After:=ThisWorkbook.Worksheets(ThisWorkbook.Worksheets.Count))
        PrepareSheet.Name = sheetName
    End If
    If PrepareSheet.AutoFilterMode Then PrepareSheet.AutoFilterMode = False
    PrepareSheet.Cells.Clear
End Function

ボタンへの登録方法は PART 06 と同じで、マクロ名は ローカルのコミット履歴を取得 を選ぶ。

コードのポイント

実行されるコマンド

マクロが組み立てるコマンドは、次のようになる(読みやすいように改行している)。

実行されるコマンド
git -C "C:\work\VBA-JSON"
    -c i18n.logOutputEncoding=UTF-8 -c core.quotepath=false
    log --output="C:\Users\...\Temp\gitlog_20261112_091500.txt"
        "--date=format-local:%Y-%m-%d %H:%M:%S"
        "--pretty=format:@@%H%x09%an%x09%ad%x09%s"
        --numstat --max-count=300 "origin/HEAD" --
部分役割
-C フォルダーそのフォルダーのリポジトリに対して実行する
-c i18n.logOutputEncoding=UTF-8出力の文字コードを UTF-8 に固定する
-c core.quotepath=false日本語のファイル名を \346\227… のような表記にしない
--output=ファイル結果をファイルに書き出す
--date=format-local:… と %ad作者日時を、実行した PC のタイムゾーンに変換して指定の形式で出力する
--pretty=format:@@%H%x09…目印 @@ に続けて、SHA・作者・日時・メッセージの1行目をタブ区切りで出力する
末尾の --直前の origin/HEAD が、ファイル名ではなく起点の指定であることを明示する

日時の変換は Git に任せる

Git が記録している日時は、コミットした人のタイムゾーンのままだ(PART 05)。Python 版は ISO 8601 形式で受け取って変換したが、VBA でタイムゾーン付きの文字列を解析するのは手間がかかる。format-local を使うと Git が PC のタイムゾーン(日本の PC なら日本時間)に変換してくれるので、VBA 側は CDate で日付型にするだけで済む。

コミットの行と --numstat の行を見分ける

--numstat を付けると、各コミットの行の後ろに「追加行数・削除行数・パス」の行が続く。

一時ファイルの内容(例)
@@1e49ba826b979d1851029dc965ecb6a3ead2a32c	Tim Hall	2019-01-29 01:05:23	v2.3.1
1	1	JsonConverter.bas
-	-	specs/VBA-JSON - Specs.xlsm

@@e0f1a77cbcbf35e39a7e406e156b87fe2e1d06d8	Tim Hall	2019-01-29 01:04:26	Update vba-utc to v1.0.6
11	0	.editorconfig
5	5	JsonConverter.bas

コミットの行の先頭に目印の @@ を付けておき、目印がある行はコミット、ない行は直前のコミットの変更ファイルとして集計している。Excel ブック(.xlsm)のようなバイナリファイルは行数が - になるので、ファイル数だけを数える。

% を含む引数と環境変数

WScript.Shell の Run は、コマンドの中の %名前% を環境変数として展開する。書式の %H や %an は、H や an という名前の環境変数がなければそのまま Git に渡るので、通常は問題にならない。万一、期待と違う結果になったときは、イミディエイト ウィンドウに表示されたコマンドと、実際の出力を見比べるとよい。

fetch はウィンドウを表示して実行する

git log はウィンドウを非表示(0)で実行しているが、git fetch は表示(1)にしている。認証が必要になったときに、入力を求める画面が隠れたままになると、Excel が応答を待ち続けて固まったように見えるからだ。

PART 06(REST API)との使い分け

観点PART 06:REST APIPART 07:ローカルクローン
事前準備VBA-JSON の取り込みと参照設定Git のインストールとクローン
トークン公開リポジトリは任意、プライベートは必須不要(クローンと fetch のときだけ認証)
回数の制限ありなし
変更行数コミットの数だけリクエストが必要1回のコマンドで全件
ブックを配るとき受け取った人はトークンの設定だけで使える受け取った人の PC にも Git とクローンが必要
GitHub のユーザー名・コミットの URL取れる取れない(Git に記録された名前だけ)

開発者が自分の PC で使うならローカル方式、Git を入れていない人にも配るなら REST API、という分け方が目安になる。

プライベートリポジトリの場合

🔒 この回のマクロで変わる点

  • コードの変更は不要。クローン済みのフォルダーを指定すれば、git log は認証なしで動く
  • B5(先に fetch する)を TRUE にすると、git fetch のときに認証が必要になる。普段ターミナルで git fetch や git pull ができている PC なら、保存済みの資格情報が使われるので、そのまま通る
  • 初めて fetch する PC では、ブラウザーでのサインインを求められることがある。先にターミナルで一度 git fetch を実行して済ませておくと確実だ(認証方法は PART 05)
  • プライベートリポジトリのコミット履歴を取り込んだブックには、非公開の情報が含まれる。共有先に注意する

つまずきやすい点

症状原因と対処
「指定されたファイルが見つかりません」git に PATH が通っていない。Git をインストールしたあと、Excel をすべて閉じて開き直す
終了コード 128 で失敗する起点の指定が間違っている(origin/main が存在しないなど)、またはフォルダーの所有者が違う(dubious ownership)。表示されたコマンドをターミナルで実行すると、理由が表示される
fetch したのに新しいコミットが出ない起点が空欄(HEAD)のままになっている。origin/HEAD やリモートのブランチ名を指定する
日時が日本時間になっていないPC のタイムゾーンが日本以外になっている。format-local は PC の設定に従う
0件になる浅いクローンで履歴がない、または起点のブランチにコミットがない
ネットワークドライブ上のクローンで遅い・失敗するローカルディスクにクローンし直す。ネットワークドライブ上のリポジトリは、所有者の確認でエラーになりやすい

✅ 次の記事では…

PART 08 では Google Apps Script で REST API を呼び、スプレッドシートにコミット履歴を取り込む。トリガーを使って、PC を起動していなくても毎朝更新されるようにする。

→ PART 08 — Google Apps ScriptでREST APIを呼ぶ へ