GitHub Actions: macos-latestでのビルドの注意点

GitHub Actionsを使ってmacOS向けのバイナリをビルドしている開発者の方へ。「ローカルでは動くのに、CI/CDでビルドしたバイナリが動かない」という問題に遭遇したことはありませんか？本記事では、

はじめに

GitHub Actionsを使ってmacOS向けのバイナリをビルドしている開発者の方へ。「ローカルでは動くのに、CI/CDでビルドしたバイナリが動かない」という問題に遭遇したことはありませんか？

本記事では、macos-latestランナーの仕様と、macOS Sequoia（15.x）環境での互換性問題について解説します。

多くの開発者が誤解しているポイントがあります。

latestは「最新版」ではなく「GitHubが推奨するデフォルト版」を指します。2024年9月にSequoiaがリリースされた後も、macos-latestはSonomaを指し続けています（2025年12月時点）。

macOSのバイナリは、ビルド時に使用されるXcode/clangのバージョンによって、動作可能な最小OSバージョンが決まります。

ビルド環境より新しいmacOSで実行する場合、ランタイムの互換性問題が発生することがあります。特に厄介なのは、エラーメッセージなしで即座に終了するケースです。

バイナリの依存関係はotool -Lコマンドで確認できます。

otool -L ./your-binary | grep libSystem

libSystemのバージョンでビルド環境を推測できます：

jobs:  build-macos:    runs-on: macos-15    steps:      - uses: actions/checkout@v4      # ... ビルドステップ

macOS 14もサポートする必要がある場合は、環境変数で下位互換性を持たせます。

- name: Build  env:    MACOSX_DEPLOYMENT_TARGET: "14.0"  run: |    # ビルドコマンド

macOSでこの問題が発生しやすい理由があります。

OS	特徴
Linux	glibcの後方互換性が高く、古い環境でビルドしても新しい環境で動作しやすい
Windows	VC++ Runtimeは別途配布が一般的で、OS依存が小さい
macOS	libSystemがOSバージョンと密結合しており、互換性問題が起きやすい