简介：面向旧款 Mac 与中低分辨率外接显示器用户的 HiDPI 开启工具包，针对系统设置中不提供高像素密度选项、需借助 RDM 等图形工具反复切换的痛点，给出可一键执行的脚本方案。压缩包共 14 个文件、约 2.05MB，以 sh 脚本和 command 可执行文件为核心，搭配 plist 配置、icns 与 tiff 图标素材、jpg/gif 操作示意及 md 说明文档，从执行到核对形成闭环。脚本通过改写显示器相关配置，让 HiDPI 选项直接出现在系统显示器设置中，随附的中英文说明与截图便于对照，图标资源可用于自定义显示器描述文件。需注意此类操作涉及系统文件写入，动手前应备份重要数据，并留意个别应用在高分辨率下出现的界面放大或布局错乱。目前已有 2054 人学习下载，适合具备一定系统操作基础、希望低成本改善旧设备显示细腻度的用户参考。

1. 2K 屏接上 Mac，字体发虚：macOS 开启 HiDPI 到底在装什么

macOS 开启 HiDPI 这件事，很多人是被一张发虚的截图逼着去查的：2K 显示器接上 Mac，系统设置里只剩「更大文本」和「更多空间」两三个档，字是大了，边缘却全是毛刺，调代码时圆括号和方括号分不清。我第一台外接屏就这么凑合用了半年，直到某天改配置改错一个字符才彻底受不了。HiDPI 不是换壁纸那种美化，它是让系统按 2 倍像素渲染界面、再缩回物理面板，逻辑分辨率砍半、像素密度翻倍。装对了，2K 屏看着接近 4K 的细腻；装错了，开机黑屏、登录界面字大如斗、外接屏直接不认。这篇写给手上有 2K 或 4K 外接屏、想把 HiDPI 真正跑起来的开发者，从版本核对一路写到装坏了怎么救。

2. 装前核对：macOS 版本、芯片与接口决定你能开到哪一档

这一章全是准备工作，但省不掉。HiDPI 在 Mac 上不是「开关一开就生效」的独立功能，它本质上是系统向显示器声明一组带 2 倍标志位的分辨率模式；系统认不认、显卡撑不撑得住、线材带宽够不够，三件事任何一件不满足，后面所有命令都是白敲。我见过太多人拿着从别处抄来的一串 override 路径直接往系统里写，写完重启发现界面糊得更厉害——因为他连自己屏幕的物理分辨率都没确认，写进去的是一档根本不存在的帧缓冲。

2.1 先确认三件事：芯片架构、系统大版本、显示器物理分辨率

三条命令，三十秒跑完，后面所有决策都靠它。

# 1) 系统大版本：决定后面走 override 目录法还是虚拟显示器法 sw_vers -productVersion # 输出 12.x / 13.x / 14.x / 15.x # 2) 芯片架构：arm64 和 x86_64 对 override 的响应差别很大 uname -m system_profiler SPHardwareDataType | grep -E "Chip|Processor Name" # 3) 显示器真实分辨率、当前帧缓冲、连接方式 system_profiler SPDisplaysDataType | grep -E "Resolution|UI Looks like|Connection Type|Display Type"

第三条命令的输出要重点看两行：Resolution是显卡当前实际渲染的帧缓冲尺寸，UI Looks like是系统报给应用的逻辑分辨率。如果两者相等，说明现在跑的是原生模式，没有 HiDPI；如果Resolution是UI Looks like的两倍（比如 3840 x 2160 对 1920 x 1080），说明 HiDPI 已经在跑了。这条判断标准后面验证章节还会反复用，先记住。

Connection Type也别忽略。HDMI 2.0 在 4K@60 上已经很紧张，再叠一层 2 倍帧缓冲，带宽不够时系统会自动降色度抽样，文字边缘会出现红蓝色边——很多人以为是 HiDPI 没开好，其实是线材和接口的锅。能用 DisplayPort 或 USB-C 走 DP Alt Mode 的，优先走这个。

显示器物理分辨率和「能开哪一档 HiDPI」是一一对应的，这张表我贴在备忘里：

看表就能明白为什么 2K 屏最难受：整数倍的 HiDPI 只有 1280×720 一档，字巨大；想要 1920×1080 的舒适档，就必须让显卡先渲染 3840×2160 再缩回 2560×1440，这一层非整数插值就是「字发虚」的根源，也是后面调参的主要战场。

2.2 版本差异：从 Monterey 到 Sequoia，入口换了三次

同一个操作在不同大版本上的入口和有效性完全不一样，这是最容易翻车的地方。

Monterey 12 及更早，系统偏好设置里点「缩放」时按住 Option 键，能直接看到一批隐藏分辨率列表，那些带 HiDPI 标志的档位就在里面，选完即生效，不需要动任何文件。这个「按住 Option」的习惯我保留到现在，Ventura 13 改版成「系统设置」之后，缩放面板的位置挪到了「显示器」页签下方，长条缩略图那排，按住 Option 点「更多空间」或「默认」附近仍能展开更多档位，只是藏得更深。

Sonoma 14 之后情况变了。一方面，部分机型上系统会直接忽略写在/Library/Displays下的 override 文件——不报错，也不生效，system_profiler里干干净净，让人怀疑自己是不是敲错了路径。另一方面，第三方显示工具开始强制要求「屏幕录制」权限，不给权限它连当前分辨率列表都读不全。我在 14.x 上第一次遇到这个，排查了四十分钟才发现是权限问题。

提示：动手之前先记下当前系统版本号，之后每次系统大版本升级都当作一次「重新装一遍」来对待，别指望配置能无损迁移。

2.3 工具选型：脚本、displayplacer、BetterDisplay 各管哪一段

三条路线不是互相替代，而是覆盖不同场景，我通常按机器情况选一条主路，另一条当备胎。

关键区别在「造分辨率」和「选分辨率」。displayplacer 的能力是后者：它把系统内部那份模式清单列出来，包括 UI 里没暴露的 HiDPI 档，然后帮你写死。所以如果displayplacer list里压根没有带scaling:on的 1920×1080，那就说明系统里没有这档，得先用 override 文件或虚拟显示器把它「造」出来。这个顺序搞反了，会浪费一整晚。

3. 命令行路线：displayplacer 加 override 文件把 1920×1080 HiDPI 写死

我偏好命令行路线的原因很实际：它能进版本库。配置写成脚本，换机器、重装系统、同事要复现，一条命令拉起来就行，不用回忆「当时点了哪个菜单」。这一章按备份、装工具、造模式、写死模式的顺序走，每一步都能单独回滚。

3.1 装 Homebrew 与 displayplacer，先做一次无损备份

Homebrew 已经装好的跳过这段，没装的按官网首页那条一行命令装完，注意 Apple Silicon 的默认前缀是/opt/homebrew，装完必须把 brew 加进 PATH，否则后面所有命令都是command not found。

# Apple Silicon 默认前缀是 /opt/homebrew；Intel 是 /usr/local echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile source ~/.zprofile which brew # 期望输出 /opt/homebrew/bin/brew

然后是备份，这一步别省。显示配置改坏之后的典型症状是开机后外接屏不亮或者登录界面分辨率错乱，那时候你连图形界面都进不去，只能靠之前的快照对照着救。

# 建一个带日期的备份目录，把当前显示相关配置全存一份 DEST="$HOME/display-backup/$(date +%F-%H%M)" mkdir -p "$DEST" # 系统级显示配置 sudo cp /Library/Preferences/com.apple.windowserver.displays.plist "$DEST/" 2>/dev/null || true # 按机器 UUID 存的 ByHost 域配置，重装系统后这个最容易丢 defaults -currentHost export com.apple.windowserver "$DEST/windowserver-byhost.plist" 2>/dev/null || true # 当前所有显示器的分辨率快照，回滚时用来对照 system_profiler SPDisplaysDataType > "$DEST/displays-before.txt" ls -l "$DEST"

三个文件各有用途：displays.plist是系统级配置，删掉它会触发系统重建默认配置，是最常用的回滚手段；windowserver-byhost.plist是按主机 UUID 存的，跨机器不可用但本机回滚关键；displays-before.txt是纯文本快照，出问题时用肉眼比对最快。

接着装 displayplacer：

brew install jakehilborn/jakehilborn/displayplacer displayplacer list

指定完整 tap 路径而不是短名，是因为短名在某些镜像配置下会解析到别的同名公式。装完的displayplacer list会打印出每个屏幕的 Persistent ID 和一大串可用模式，输出很长，建议重定向到文件再看：

displayplacer list > ~/display-backup/displayplacer-modes.txt grep -n "scaling:on" ~/display-backup/displayplacer-modes.txt | head -20

有scaling:on的行就是系统认的 HiDPI 档。有 1920×1080 的直接走 3.2，没有的跳到 3.3 造一档出来。

3.2 用 displayplacer 列出所有模式并写入 scaling:on

假设list的输出里已经出现了目标档，抄下它的 Persistent ID（形如1A2B3C4D-...的一长串），拼成一条完整的设置命令。

# 参数逐项说明： # id 用 Persistent ID，不要用 display ID——后者换接口就变 # res 逻辑分辨率，1920x1080 是 2K 屏上最舒服的一档 # hz 刷新率，60 是保守值，面板支持 75/144 的可以往上试 # scaling on 表示按 2 倍像素渲染，这才是 HiDPI 的开关 # origin 多屏时的坐标原点，单屏写 (0,0) 即可 # degree 旋转角度，竖屏改 90 displayplacer "id:1A2B3C4D-0000-0000-0000-000000000000 res:1920x1080 hz:60 color_depth:8 scaling:on origin:(0,0) degree:0"

命令执行后屏幕会黑一下再亮，这是窗口服务在重建帧缓冲，正常。scaling:on是整条命令里唯一不能省的部分，漏了它就是普通缩放，画面照样糊。color_depth:8表示每通道 8 位，改成 10 位需要面板和线材同时支持，硬写 10 位在带宽不够时会直接黑屏几秒然后回退，反而更乱。

这条命令写死之后要固化下来，否则重启就没了。我一般是把带 Persistent ID 的那行存成~/bin/hidpi-on.sh，再加一个 LaunchAgent 在登录时跑。用固定脚本的好处是，哪天想临时切回原生模式，改一行参数重跑就行，不用重新翻菜单。

3.3 手工生成 override 文件：DisplayProductID 与 scale-resolutions 怎么写

displayplacer list里没有目标档的时候，就得自己造。原理是给这块显示器塞一份「额外支持的分辨率清单」，系统读到之后会把这些模式加进候选列表。

第一步，从 IORegistry 里读显示器的厂商 ID 和产品 ID：

# 读出来通常是十进制，记下这两个数 ioreg -lw0 | grep -i "DisplayProductID" | head -3 ioreg -lw0 | grep -i "DisplayVendorID" | head -3 # 十六进制和十进制互转，override 的目录名要 4 位小写十六进制 printf '%x\n' 26222 printf '%d\n' 0xabcd

第二步，生成scale-resolutions需要的那串 Base64 数据。它的结构很简单：宽 4 字节、高 4 字节、标志位 4 字节，全部大端序，标志位写 1 表示这是一档 HiDPI 模式。

# gen-scale-resolutions.py # 生成 override 文件里 scale-resolutions 需要的 Base64 数据 # 12 字节 = 宽 4B + 高 4B + 标志位 4B，全部大端；标志位 1 表示 HiDPI import base64 import struct import sys def blob(width, height, hidpi=True): flags = 1 if hidpi else 0 return base64.b64encode(struct.pack(">III", width, height, flags)).decode() if __name__ == "__main__": w, h = int(sys.argv[1]), int(sys.argv[2]) print(f"{w}x{h} 帧缓冲 -> {blob(w, h)}")

注意这里传的是帧缓冲尺寸，不是逻辑分辨率。想要 1920×1080 的 HiDPI，传的是3840 2160：

python3 gen-scale-resolutions.py 3840 2160 | awk '{print $NF}'

第三步，把数据写进 override 文件。目录名必须是DisplayVendorID-加 4 位小写十六进制，文件名必须是DisplayProductID-加 4 位小写十六进制，少一位都不认。

# 这里的 VID / PID 换成你自己 ioreg 读到的值 VID_HEX=abcd PID_HEX=1234 DATA=$(python3 gen-scale-resolutions.py 3840 2160 | awk '{print $NF}') sudo mkdir -p "/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-$VID_HEX" sudo tee "/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-$VID_HEX/DisplayProductID-$PID_HEX.plist" >/dev/null <<PLIST <?xml version="1.0" encoding="UTF-8"?> <plist version="1.0"> <dict> <key>DisplayProductID</key> <integer>$PID_HEX</integer> <key>DisplayVendorID</key> <integer>$VID_HEX</integer> <key>scale-resolutions</key> <array> <data>$DATA</data> </array> </dict> </plist> PLIST

写进 plist 的<integer>用十六进制带0x前缀在某些解析器里会读成 0，所以我一般统一转成十进制再填，稳一点。scale-resolutions是个数组，要一次给多档就往里加多个<data>，比如同时加 3840×2160 和 3200×1800，系统会把它们都列进候选。

注意：/System/Library/Displays/Contents/Resources/Overrides是系统卷，从 Big Sur 起只读，别去动它，更不要为了改它去关 SIP。所有自定义都放/Library/Displays/...，够用且可逆，删目录就恢复。

3.4 重启窗口服务并确认帧缓冲尺寸

文件写完不会立刻生效，得让窗口服务重新加载显示配置。

# 会闪一下屏，先把手上的活儿存了 sudo killall -HUP WindowServer # 等三秒再看结果 sleep 3 system_profiler SPDisplaysDataType | grep -E "Resolution|UI Looks like"

期望输出里Resolution是 3840 x 2160 这类大数，UI Looks like是 1920 x 1080。如果两行数字相等，或者UI Looks like这行根本没出现，说明 override 没被读进去，回到 3.3 检查目录名和文件名。Sonoma 之后部分机型确实会无声忽略这份文件，那时候别硬刚，直接转第四章的虚拟显示器方案，能省下不止一个晚上。

能读到之后，回到 3.2 用 displayplacer 把这一档写死，链路就闭环了：override 负责「让系统知道有这档」，displayplacer 负责「每次开机自动选这档」。

4. 图形界面路线：BetterDisplay 建虚拟屏，把缩放档位固化下来

命令行路线在 Intel 机型上很顺，但换到 Apple Silicon 加新系统，我越来越依赖虚拟显示器。原理不复杂：让工具在系统里注册一块「不存在的屏幕」，分辨率随便定，再由它把这块虚拟屏的画面缩放到物理屏上。好处是不碰系统目录，坏处是多一个常驻进程，且要授权。

4.1 安装、授权与首次创建虚拟显示器

装法就是常规的 dmg 拖进/Applications。首次打开会被拦，去「系统设置 → 隐私与安全性」点「仍要打开」放行，这一步每次大版本更新后可能要重来一次。装完先确认落位：

ls -d /Applications/BetterDisplay.app # 顺便看看有没有常驻登录项，没有的话后面手动加 osascript -e 'tell application "System Events" to get the name of every login item' 2>/dev/null

接着是权限。Sonoma 之后这类工具需要「屏幕录制」权限才能读全分辨率列表，不给的话菜单里只会显示当前那一档，看起来像功能缺失。第一次打开时按提示跳转授权，授完必须完全退出应用再重开，改权限不重启进程是不生效的，这个坑我踩过两次。

创建虚拟屏的入口在菜单栏图标里，措辞会随版本变，认这几个关键词就行：Virtual Screen、Create、HiDPI、Associate。选 16:9 比例、逻辑分辨率填 1920×1080、勾上 HiDPI，然后把它关联到那块物理屏，画面就会从虚拟屏缩放到面板上。

4.2 把 1920×1080 HiDPI 固化成默认档位

虚拟屏建好之后先别急着高兴，重插一次线试试。虚拟显示器和物理屏的关联关系是按接口记的，同一条线同一个口能记住，换个口就丢。我一般按下面的顺序固化：

第一步，在工具里给每块物理屏单独存一份配置，命名带上接口类型，比如2K-DP、2K-HDMI，拔插之后手动切一次，之后就记住了。

第二步，打开开机自启。这个选项在不同版本里位置不一样，有的在「General」，有的在「Settings → Startup」，翻不到就用系统设置里的登录项加上。

第三步，导出配置进备份目录。工具的域名不一定是想当然的那个，先列出来再导：

# 先找到这个 app 真实的 defaults 域名 defaults domains | tr ',' '\n' | grep -i -E "better|display" # 用上一步查到的域名导出，替换下面的占位 defaults export <查到的域名> ~/display-backup/betterdisplay.plist

导出这一步看着多余，直到有次系统升级后工具的配置全清空、虚拟屏要重建一遍。从那之后我把它和 displayplacer 的快照放在同一个目录，重装系统后一起恢复。

4.3 多屏记忆与切换脚本

两块以上外接屏的时候，纯靠工具记忆会乱：接一台、接两台、只留笔记本，三种状态各自需要一套配置。我的做法是每个场景写一个切换脚本，用 displayplacer 兜底，工具负责虚拟屏本身。

#!/usr/bin/env bash # ~/bin/display-work.sh —— 工位双屏场景 set -euo pipefail # 主屏：2K 走 1920x1080 HiDPI；副屏：竖屏 1080x1920 原生 displayplacer \ "id:AAAA-0001 res:1920x1080 hz:60 color_depth:8 scaling:on origin:(0,0) degree:0" \ "id:AAAA-0002 res:1080x1920 hz:60 color_depth:8 scaling:off origin:(1920,0) degree:90" echo "已切到工位双屏配置"

set -euo pipefail是为了让脚本在任意一条命令失败时立刻退出，不然 displayplacer 报错被吞掉，你还以为切成功了。副屏写scaling:off是有意的：竖屏看文档用原生分辨率字够大，再开 HiDPI 反而浪费带宽。这类「主屏 HiDPI、副屏原生」的混搭，实际用起来比两块都开更稳。

5. 排查与避坑：五条把显示配置搞坏过的记录

下面五条是我真实翻车过的，按「现象 → 原因 → 解决」记，遇到类似的直接对号入座。

5.1 写了 override 文件，重启也执行了，缩放面板里什么也没多

现象：/Library/Displays/Contents/Resources/Overrides下文件明明在，killall -HUP WindowServer也跑了，系统设置里候选分辨率一个没变，system_profiler输出和改之前一模一样。

原因：三种可能。目录名或文件名不是 4 位小写十六进制，比如写成了DisplayVendorID-0xABCD；plist 里的<integer>用了带0x前缀的值被解析成 0；或者机型加系统版本压根不读这个目录，Sonoma 之后的 Apple Silicon 上这一条概率最高。

解决：先用plutil -lint校验 plist 语法，再把目录名和文件名逐字符对一遍。如果都正确仍不生效，就别耗了，直接转虚拟显示器方案。判断是否属于「系统不读」有个快办法：随便写一档夸张的分辨率进去，重启窗口服务后看system_profiler有没有变化，一点没变就是整份文件被忽略。

5.2 缩放开了，但字发虚、鼠标拖动有拖影

现象：UI Looks like已经是 1920×1080，理论上 HiDPI 生效了，可文字边缘发灰，快速拖动窗口有残影，看久了眼睛累。

原因：非整数缩放。2K 面板上跑 1920×1080 的逻辑分辨率，显卡要渲染 3840×2160 再缩到 2560×1440，插值比例是 1.5 倍，像素无法一一对应就必然发虚。另一个叠加因素是带宽不够导致系统自动降了色度抽样，文字边缘出现红蓝彩边。

解决：优先换档位，1600×900 或 2048×1152 在 2K 上插值比例更友好，观感往往比 1920×1080 更实。换档没改善就查线材，把 HDMI 换成 DP 或 USB-C 直连，同时在system_profiler输出里确认色深和色度格式。实在要保住 1920×1080，就用虚拟屏的平滑缩放算法，它比系统自带的插值做得好一些。

5.3 拔掉显示器再插回来，HiDPI 就没了

现象：合盖带走再回来，或者换了个接口插，屏幕分辨率回到原生，发的虚字又回来了，得手动去设置里重新点一次。

原因：系统按接口和显示器的组合记忆模式，HDMI 口和 DP 口在系统眼里是两块不同的屏。加上外接屏的 display ID 每次连接可能变，写死的命令就对不上了。

解决：所有脚本里统一用 Persistent ID 而不是 display ID，前者跟显示器走、不跟接口走。再就是加登录项，把切换脚本挂在登录时执行，拔插后手动跑一次也行。双接口来回切的话，给每个口各存一份配置，别指望一份通吃。

5.4 系统更新后开机黑屏，或登录界面字大如斗

现象：升级完重启，外接屏黑着，或者登录界面分辨率明显不对，进了桌面反而正常。

原因：override 里只写了一档非原生分辨率，系统在登录界面阶段读取候选列表时拿它当了唯一可用模式，而此时显卡驱动还没完全加载，撑不起那么大的帧缓冲，于是黑屏或降级。

解决：进恢复模式，用终端把整个 Overrides 目录删掉，重启让系统重建默认配置：

# 恢复模式的终端里执行；正常系统里执行会直接生效，慎用 rm -rf /Volumes/*/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-*

预防办法是scale-resolutions里至少保留一档原生整数倍分辨率，让系统在早期阶段有退路。我现在的习惯是每个 override 文件里都留原生档加目标档两条，不再写单条。

5.5 截图尺寸突然变成 3840×2160，以为出了 bug

现象：Cmd+Shift+3截个全屏，文件尺寸是 3840×2160，比屏幕物理分辨率还大，贴到聊天窗口里显示不全。

原因：这不是 bug。HiDPI 模式下截图按帧缓冲的物理像素输出，逻辑分辨率 1920×1080、实际渲染 3840×2160，截出来自然是后者。同理，网页里用window.devicePixelRatio读到的值会变成 2。

解决：需要逻辑像素尺寸的图，截完缩一半：

# 把截图等比缩到 1920 宽，保留清晰度同时回到逻辑尺寸 sips -Z 1920 ~/Desktop/shot.png --out ~/Desktop/shot-1920.png

做前端调试的反而要利用这个特性：devicePixelRatio为 2 时正好用来验证 2 倍图和高清屏适配，比真机借设备方便。

6. 装完怎么验证：三处对照和一个固定习惯

装完不等于装对。我验收 HiDPI 从来不看「感觉清楚了没有」，那东西主观且容易自我暗示，只认三处硬指标。

第一处是system_profiler的两行对照，这是最权威的：

system_profiler SPDisplaysDataType | awk -F': ' '/Resolution|UI Looks like/{printf " %-16s %s\n", $1, $2}'

判断标准固定：Resolution必须约等于UI Looks like的两倍。比值是 2 就对了，是 1 说明 HiDPI 没生效，是 1.5 之类说明跑在了非整数缩放上，能用但不锐利。

第二处是截图尺寸，前面 5.5 说过，截图输出等于帧缓冲尺寸就说明渲染层确实是 2 倍。这个方法的好处是不依赖任何工具，重装系统后第一时间就能验。

第三处是重启后的稳定性。很多人配置完当时是好的，重启就回退，原因是没做持久化。所以验收必须包含一次完整重启，重启后重新跑上面那条命令，数字不变才算过关。

三处对照的期望值整理成表：

本文还有配套的精品资源，点击获取