3种方法安装qlImageSize：Homebrew、手动安装与源码编译全攻略

3种方法安装qlImageSize：Homebrew、手动安装与源码编译全攻略

【免费下载链接】qlImageSizeQuickLook and Spotlight plugins to display the dimensions, size and DPI of an image in the title bar instead of the filename. Also preview some unsupported formats like WebP & bpg.项目地址: https://gitcode.com/gh_mirrors/ql/qlImageSize

qlImageSize是一款实用的QuickLook和Spotlight插件，能够在标题栏显示图片的尺寸、大小和DPI信息，替代默认的文件名显示，同时支持WebP、BPG等特殊图片格式的预览功能。本文将详细介绍三种安装方式，帮助你快速配置这款高效的图片信息查看工具。

📦 方法一：Homebrew一键安装（推荐新手）

Homebrew是macOS系统下最便捷的包管理工具，通过它安装qlImageSize只需两条命令即可完成：

1. 打开终端应用
2. 输入以下命令并回车：

   brew install --cask qlimagesize mdimagesizemdimporter

安装完成后，系统会自动处理插件注册和QuickLook服务重启，无需额外配置即可立即使用。该方法适用于大多数普通用户，全程自动化操作，避免手动配置可能出现的错误。

🛠️ 方法二：手动安装（适合高级用户）

如果你的系统无法使用Homebrew，或需要特定版本的插件，可以选择手动安装方式：

步骤1：下载插件文件

从项目仓库获取最新的发布包，包含以下核心组件：

• qlImageSize.qlgenerator（QuickLook插件）
• mdImageSize.mdimporter（Spotlight元数据插件）

步骤2：安装QuickLook插件

将qlImageSize.qlgenerator文件复制到以下目录之一：

• 用户级别（推荐）：~/Library/QuickLook/
• 系统级别：/Library/QuickLook/

步骤3：安装Spotlight插件

将mdImageSize.mdimporter文件复制到以下目录之一：

• 用户级别：~/Library/Spotlight/
• 系统级别：/Library/Spotlight/

步骤4：刷新插件缓存

打开终端执行以下命令使插件生效：

qlmanage -r qlmanage -r cache mdimport -r /path/to/mdImageSize.mdimporter

🔨 方法三：源码编译安装（开发者选项）

对于希望自定义功能或贡献代码的开发者，可以通过源码编译方式安装：

准备工作

确保系统已安装Xcode开发工具和必要依赖：

xcode-select --install

编译步骤

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/ql/qlImageSize cd qlImageSize

2. 编译依赖库：

   # 进入libwebp目录编译WebP支持库 cd deps/libwebp CFLAGS="-mmacosx-version-min=10.13" ./configure --disable-shared make

3. 使用Xcode编译主项目：

   open qlImageSize.xcodeproj

   在Xcode中选择"qlImageSize"目标，点击"Build"按钮完成编译。

4. 安装编译产物： 编译完成后，在build/Release目录下会生成插件文件，按照方法二中的手动安装步骤进行部署。

📝 验证安装

安装完成后，可以通过以下方式验证插件是否正常工作：

1. 选择任意图片文件
2. 按下空格键打开QuickLook预览
3. 检查标题栏是否显示图片尺寸和大小信息（例如："image.jpg (1920×1080, 2.4MB)"）

若标题栏仍显示原始文件名，请尝试重启Finder或注销当前用户后重新登录。

🗑️ 卸载方法

如需卸载qlImageSize，可根据安装方式选择对应方法：

• Homebrew安装：

  brew uninstall --cask qlimagesize mdimagesizemdimporter

• 手动安装：

  # 删除QuickLook插件 rm -rf ~/Library/QuickLook/qlImageSize.qlgenerator # 删除Spotlight插件 rm -rf ~/Library/Spotlight/mdImageSize.mdimporter # 刷新缓存 qlmanage -r mdimport -r

通过以上三种方法，你可以根据自己的技术水平和需求选择最适合的安装方式。qlImageSize插件支持多种图片格式，包括WebP（com.google.webp）、BPG（fr.whine.bpg）和NetPBM系列格式（fr.whine.ppm/pbm/pgm），为图片管理提供更丰富的元数据支持。

【免费下载链接】qlImageSizeQuickLook and Spotlight plugins to display the dimensions, size and DPI of an image in the title bar instead of the filename. Also preview some unsupported formats like WebP & bpg.项目地址: https://gitcode.com/gh_mirrors/ql/qlImageSize