The common thread
Some macOS errors are not selectable text. They are drawn: dialogs, IDE overlays, console panes, the page image of a PDF. You cannot drag-select them, you cannot copy them, and Cmd+F finds nothing.
That changes the workflow. Normally you copy the message, paste it into a search engine, and read. Here you first have to get the text out. Below are five errors I hit repeatedly, each with the real triage commands first — and a note on the reading problem second.
Every screenshot is a real screen, reproduced as a before/after comparison.
1. Gatekeeper: "cannot be opened because the developer cannot be verified"
"AppName" cannot be opened because the developer cannot be verified. The variant that makes people panic:
"AppName" is damaged and can't be opened. You should move it to the Trash. Neither means the binary is corrupt. Check, in order:
# 1. is the quarantine attribute attached? xattr -l /Applications/AppName.app # 2. what does Gatekeeper think? spctl --assess --type execute -vv /Applications/AppName.app # 3. is it signed at all? codesign -dv --verbose=4 /Applications/AppName.app If codesign reports code object is not signed at all, the build is unsigned — usually an ad-hoc distribution. If the distributor is trustworthy and only the quarantine flag blocks it:
xattr -dr com.apple.quarantine /Applications/AppName.app Or from the GUI: right-click → Open → Open once.
The expensive mistake is deleting the app because the dialog said "damaged".
2. Xcode: codesign failed with exit code 1
Command /usr/bin/codesign failed with exit code 1 Three things determine this, in this order: certificate → provisioning profile → Bundle ID.
# 1. do we have a usable signing identity? security find-identity -v -p codesigning # 2. what is the build actually going to use? xcodebuild -showBuildSettings 2>/dev/null \ | grep -iE "CODE_SIGN|provisioning|DEVELOPMENT_TEAM" # 3. what happened, verbosely? xcodebuild -scheme YourScheme -configuration Debug build 2>&1 \ | grep -iE "codesign|signing|profile" The three common causes:
-
security find-identityreturns 0 valid identities → no certificate in the keychain -
DEVELOPMENT_TEAMis empty → no team selected - profile Bundle ID ≠ target Bundle ID
Verify an already-built product:
codesign --verify --deep --strict --verbose=2 App.app 3. Rust / Cargo: the linker error is a result, not a cause
error: linking with `cc` failed: exit code: 1 The cause is a few lines above:
ld: symbol(s) not found for architecture arm64 clang: error: linker command failed with exit code 1 So read backwards:
# pull the linker lines, not only the last line cargo build 2>&1 | grep -nE "ld:|undefined|note: reference|error:" | head -40 # what did the linker actually try? cargo build -v 2>&1 | tail -60 # what does the binary ask for? otool -L target/debug/your_bin | head nm -u target/debug/your_bin | head Typical causes: architecture mismatch (arm64 vs x86_64), an unresolved C/Objective-C symbol from build.rs, or a library path that needs RUSTFLAGS="-L /opt/homebrew/lib".
4. Homebrew: undefined method / invalid option
Error: undefined method `writable?' for nil:NilClass Error: invalid option: --with-python3.8 Homebrew puts the conclusion on line 1. brew doctor comes second, not first.
# 1. sync the core first brew update # 2. then read errors only (warnings are normal and noisy) brew doctor 2>&1 | grep -nE "^Error|Warning: " | head -20 # 3. which prefix are we even using? brew --prefix -
invalid option→ the flag was removed (--with-*is largely gone) -
undefined method→ core/formula version mismatch, usually fixed bybrew update - still broken →
brew reinstall <name>
5. Two-column PDFs: copy-paste scrambles the columns
Copy a paragraph from a two-column paper and the right column's opening gets glued to the left column's ending. Nothing is corrupted — the reading order is wrong, because extraction walks the row, not the column.
# does the PDF even have a text layer? pdffonts paper.pdf # extract preserving layout, then check the order pdftotext -layout paper.pdf out.txt Two fixes that work:
- Copy per column — select only the left column, then only the right one.
- Read a region instead of the stream — in Preview, hold
⌥while dragging to force a rectangular selection, or capture the region and read it in place.
Reading the ones you cannot copy
The commands above all assume you can read the message. Half the time you cannot: the dialog has no text layer, the IDE overlay disappears when the pointer moves, the console pane refuses selection.
What I do instead of re-typing error messages by hand: press ⌃S, drag a box over the region, read the result in place. Escape closes it.
How it is wired, because the boundary matters for anyone under an NDA:
- Recognition runs on-device via Apple Vision. The screen capture is not uploaded — the image stays local.
- Translation is online. Only the recognized text is sent; the image never is.
- Offline: recognition still works, translation does not.
Environment: macOS 13 or later, Apple silicon (arm64) only — it does not run on Intel Macs. The build is not notarized, so first launch is right-click → Open (see section 1 for why that warning is not corruption).
The full gallery — 18 real errors, same triage format for each entry:
Unity の Metal シェーダ警告の切り分け
The pattern worth keeping
- Dialogs are drawings. Check
spctl/codesign/xattrbefore trusting the wording. - Linker and build errors are bottom-up. The last line is the result; the cause is above it.
- Package managers put the conclusion first. Read line 1 before running the doctor.
- Column order is a layout problem, not an OCR accuracy problem. Changing the extraction route fixes the symptom.
- Get the text out without retyping it. Re-typing
cannot be opened because the developer cannot be verifiedfrom a screenshot is where the hour goes.








