Zipp アプリアイコンZippmacOS / arm64
開発 / Rust

cargoのリンカエラーは「上にある原因」を先に読む

cargo build の「linking with `cc` failed: exit code: 1」は結果です。本当の原因は ld: 行や undefined reference に書かれています。読み進める順序と確認コマンドをまとめました。

Rustのcargoビルドで出たリンカエラーの実画面と、日本語化した比較
実画面(公開されたバグ報告の画面)をもとにした Before/After 比較。Rustのcargoビルドで出たリンカエラーの実画面と、日本語化した比較

画面に出る英語(原文)

error: linking with `cc` failed: exit code: 1
ld: symbol(s) not found for architecture arm64

症状:ビルドの最後だけが赤く出て、どこを直せばよいか分からない。

切り分け手順(3ステップ)

  1. `cargo build 2>&1 | grep -nE "ld:|undefined|error:" | head -40` で、リンカ側の行を先に拾う。
  2. `cargo build -v 2>&1 | tail -60` で、どのライブラリをどこから探したかを確認する。
  3. アーキテクチャの混在(arm64 と x86_64)を疑い、`otool -L` と `nm -u` で実行バイナリの要求を確認する。

このエラーが「選択できない」ときの読み方

文字認識は端末内(Apple Vision)。画面キャプチャの画像は外部に送信しません。翻訳はオンラインで、送るのは認識したテキストのみです。オフラインでは文字認識のみ動作し、翻訳は表示されません。

動作環境:macOS 13 以降 / Apple Silicon(arm64)専用(Intel Mac は非対応)。初回起動は「右クリック →「開く」」で実行(未公証のため。アプリの破損ではありません)

⬇ 無料でダウンロード(登録不要・.zip)ブラウザで体験する

初回起動 3 ステップ
  1. ZIP を解凍して Zipp.app を Applications へ移動
  2. 右クリック →「開く」 を選択
  3. 確認画面でも「開く」を選択

SHA-256:66920f0b335fe7526184a6004df09bcb923e77bfc49f436ecfcc3b896dee84bb

macOS 13 以降 / Apple Silicon(arm64)専用 / 日本語固定 UI。Intel Mac は対象外です。

ほかの実機エラー

図鑑の一覧へ ›