qlImageSize 项目常见问题解决方案

项目基础介绍

qlImageSize 是一个开源项目，旨在通过 QuickLook 和 Spotlight 插件，在 macOS 系统中显示图像的尺寸、大小和 DPI，而不是默认的文件名。该项目还支持预览一些不受支持的图像格式，如 WebP 和 bpg。qlImageSize 项目主要使用 Objective-C 和 Swift 进行开发，适用于 macOS High Sierra (10.13) 及以上版本。

新手使用注意事项及解决方案

1. 安装问题

问题描述：新手在安装 qlImageSize 时可能会遇到安装失败或无法正常使用的情况。

解决步骤：

• 使用 Homebrew Cask 安装：

  1. 打开终端。
  2. 输入命令：brew install --cask qlimagesize mdimagesize。
  3. 等待安装完成，重启 Finder 或系统。

• 手动下载安装：

  1. 访问项目的 GitHub 发布页面。
  2. 下载最新版本的 .qlgenerator 和 .mdimporter 文件。
  3. 将文件分别放置在 ~/Library/QuickLook 和 ~/Library/Spotlight 目录下。
  4. 重启 Finder 或系统。

2. 预览问题

问题描述：安装后，某些图像格式（如 WebP）可能无法正常预览。

解决步骤：

• 检查插件是否正确安装：

  1. 确保 .qlgenerator 文件已正确放置在 ~/Library/QuickLook 目录下。
  2. 重启 Finder 或系统。

• Pixelmator 冲突解决：

  1. 打开终端。
  2. 输入命令：nano /Applications/Pixelmator.app/Contents/Library/QuickLook/PixelmatorLook.qlgenerator/Contents/Info.plist。
  3. 删除处理 WebP 格式的 <dict> 条目。
  4. 保存并退出。
  5. 使用 unsign 工具对 Pixelmator 的 QuickLook 二进制文件进行签名。

3. 卸载问题

问题描述：新手在卸载 qlImageSize 时可能会遇到卸载不彻底或残留文件的问题。

解决步骤：

• 使用 Homebrew Cask 卸载：

  1. 打开终端。
  2. 输入命令：brew uninstall --cask qlimagesize mdimagesize。
  3. 确认卸载完成。

• 手动卸载：

  1. 打开终端。
  2. 输入命令：rm -rf ~/Library/QuickLook/qlImageSize.qlgenerator ~/Library/Spotlight/mdImageSize.mdimporter。
  3. 确认文件已删除。

通过以上步骤，新手可以更好地理解和使用 qlImageSize 项目，解决常见问题。