Xcode9 Quick Help Inspector磁盘I/O错误修复求助

Hey, I’ve helped a few devs work through this exact Quick Help error before—it almost always ties back to corrupted documentation caches or disk permission issues. Let’s walk through some fixes step by step, start with the simplest ones first:

• Restart Xcode and your Mac
  Sometimes the issue is just a temporary glitch in cached processes. Quit Xcode completely (not just minimize it), restart your Mac, then launch Xcode again and check Quick Help.

• Delete Xcode’s Documentation Cache
  Corrupted cache files are the most common culprit here. Navigate to this folder in Finder:
  ~/Library/Developer/Xcode/DocumentationCache
  Delete everything inside it (or the whole folder), then restart Xcode. It’ll rebuild the cache automatically when you next use Quick Help.

• Reset Xcode Preferences
  If the cache reset doesn’t work, corrupted preferences might be causing the issue. Open Terminal and run this command:
  defaults delete com.apple.dt.Xcode
  Note: This will reset all your Xcode preferences (like custom shortcuts, layout settings, etc.), so you might want to back up your preferences first if you’ve customized a lot. After running the command, restart Xcode.

• Repair Disk Permissions and Run Disk First Aid
  Disk I/O errors can point to permission issues or minor disk corruption. Open Disk Utility (found in Applications > Utilities), select your startup disk, click the First Aid button, and follow the prompts to repair the disk. For older macOS versions, you can also run this Terminal command to repair permissions:
  diskutil repairPermissions /

• Reinstall Xcode Documentation
  The documentation itself might be corrupted. Open Xcode, go to Xcode > Settings > Components, find the Documentation entry, click the "Uninstall" button, wait for it to finish, then click "Install" to download a fresh copy. Restart Xcode after installation completes.

• Reinstall Xcode (Last Resort)
  If none of the above work, a clean reinstall of Xcode might be necessary. First, uninstall Xcode completely: drag it from Applications to the Trash, then delete these related folders to remove leftover files:

  • ~/Library/Developer/Xcode
  • ~/Library/Caches/com.apple.dt.Xcode
  • ~/Library/Preferences/com.apple.dt.Xcode.plist
    Then download a fresh copy from the App Store or Apple Developer website, install it, and check if Quick Help works again.

If you still run into the issue after all these steps, it might be worth checking your disk’s SMART status (using Disk Utility or third-party tools like DriveDX) to rule out hardware-level disk problems.

内容的提问来源于stack exchange，提问作者Landon