简介：面向旧款苹果电脑中低分辨率屏幕用户，以one-key-hidpi-master脚本为核心，解决系统设置中无法直接开启HiDPI模式的痛点，无需安装RDM等图形化切换工具，通过命令行即可完成启用操作，适合具备一定终端基础的设计师、图像编辑及普通用户。压缩包共14个文件，大小约2.05MB，类型涵盖可执行的command与sh脚本、plist系统配置、多款显示图标icns、jpg/gif/tiff效果预览图，以及中英文说明文档，形成从执行脚本到验证效果的完整资源链。目前已有2047人学习下载，对于希望在旧款设备上获得更清晰文字和图像显示的用户，提供了行之有效的参考。脚本通过对系统底层显示参数与配置文件的修改来实现HiDPI，配套文档详细说明了执行前提、备份建议和风险提醒；同时附带的图标素材可用于自定义显示器标识，帮助用户在不更换硬件的情况下获得更舒适的视觉体验。
1. macOS 开启 HiDPI：外接 4K 屏糊成一团的根源在这
某开发者把团队配的 4K 显示器接到 MacBook 上，第一眼就愣住了：字小得贴脸才能看清，进入系统设置把缩放拉到最大，文字边缘立刻糊成一团。这种“怎么调都不对”的状态，根源就是 macos hidpi 档位没被系统识别。外接 4K 在默认情况下经常只给出 1080P 缩放档，逻辑分辨率上不去，物理像素点对点渲染自然无从谈起。装不好会怎样？字发虚、图标发毛、看几小时眼睛酸胀，甚至会被错误缩放档带偏，以为显示器本身素质不行。这篇笔记适合正在被外接显示器折磨的人——不管你有没有装过第三方工具，按我这套手写方案走一遍，能自己把档位加回来，还能在系统升级后自己修好它。
2. 搞懂 HiDPI 原理：分辨率缩放、EDID 与 plist 是同一件事
2.1 为什么系统不给你开 HiDPI
HiDPI 的核心不是“分辨率变高”，而是逻辑分辨率减半、物理像素四合一。拿 4K 屏举例：面板物理分辨率是 3840×2160，开启 1920×1080 HiDPI 档位后，系统用 1920×1080 的逻辑画布绘制界面，再把每个逻辑像素映射到 2×2 的物理像素上。这样文字笔画边缘有明确的像素网格支撑，渲染出来是锐利的；而没有 HiDPI 的普通 1080P 缩放，是直接把 3840×2160 压缩绘制到 1920×1080 画布上，再拉伸回物理面板，边缘自然发虚。
为什么系统默认不给外接屏足够的 HiDPI 档位？关键在于显示器 EDID 里的信息不完整。系统需要从 EDID 中读取厂商 ID、产品 ID、支持的分辨率列表和像素时钟参数，才能判断这块屏“够不够格”进入完整缩放列表。不少第三方显示器、转接线、老款面板的 EDID 写得简陋，系统就会保守地只给几个基本档位。说白了，不是硬件不支持，是系统不认识你。
2.2 开启 HiDPI 的两条路线：系统 Overrides 注入与用户目录注入
老教程里最常见的方法是往系统目录写 plist：修改/System/Library/Displays/Contents/Resources/Overrides/下对应厂商目录的 DisplayVendorID 文件，把自定义分辨率注入系统的显示配置数据库。这条路在旧版本系统上确实有效，但新系统对系统目录做了签名校验和读写保护，直接写入要么被拒，要么需要在恢复模式里关闭系统完整性保护，风险不小。
我更推荐走用户目录注入：在~/Library/Displays/Contents/Resources/Overrides/下建同样的 DisplayVendorID 目录结构，放一份 plist。系统读取显示配置时，用户目录优先级高于系统目录，不需要关闭任何保护机制，升级系统时也不容易被清理掉。两条路线改的文件格式完全一样，区别只在放哪、要不要关保护。
2.3 版本选择与前置工具
这套手写方案对 macOS 11 之后的版本基本通吃。需要注意版本差异：新版系统对 plist 的格式和字段校验更严格，旧教程里那种只塞一个 scale-resolutions 数组的做法，在新系统上可能直接忽略；有些用第三方脚本生成的配置，在系统大版本更新后失效，多半也是字段规范变了。我一般优先用系统自带的 plistlib 生成配置，格式由系统库自己把控，比手写 XML 稳。
前置工具很简单：一台 Mac、一块外接显示器、系统自带的终端。需要用到 Python3（macOS 自带）、plistlib（Python 标准库）、system_profiler 和 ioreg（系统自带命令）。不需要额外安装任何东西，这也是这套方案最省心的地方。如果你手头有以前下载的某开源一键脚本，原理和我下面写的完全一致，看完你能自己修脚本的 bug。
3. 手动开启 HiDPI：从读取显示器信息到生成 plist 全流程
3.1 第一步：读取外接显示器的 VendorID 与 ProductID
动手改配置之前，先拿到显示器的身份证：厂商 ID 和产品 ID。这两个值决定了 plist 该放在哪个目录、叫什么文件名，写错一个字符系统就不认。
system_profiler SPDisplaysDataType | grep -E "VendorID|ProductID"system_profiler是 macOS 自带的硬件信息查询命令，SPDisplaysDataType参数指定只查显示器数据，再用grep把 VendorID 和 ProductID 两行过滤出来。这条命令在绝大多数机器上都能用，输出的是十进制数字。如果这条命令没输出，说明系统没从 EDID 里读出完整信息，可以换 ioreg 从 I/O 注册表里挖：
ioreg -lw0 | grep -i "DisplayVendorID\|DisplayProductID"ioreg遍历 I/O Registry 的全部节点，-l显示详细信息，-w0不换行截断，方便 grep 到完整的键值对。注意 ioreg 输出的数值可能是十六进制，也可能是十进制，要看前面的前缀。我自己遇到的坑是：有些转接器会把 VendorID 报成 0，这时候要先把转接器拔掉直连显示器再查，否则后面生成的路径全是错的。
拿到十进制 ID 后，要转成十六进制用于目录名。比如 VendorID 十进制 4268 转十六进制就是 0x10AC，ProductID 十进制 45632 转十六进制是 0xB240。转换可以用printf '%x\n' 4268，不用心算。
3.2 第二步：用 Python 生成 plist 配置
这一步是本方案的核心。我们需要生成一个包含scale-resolutions数组的 plist，数组里放的是自定义分辨率档位。关键点在于：每个档位必须按大端序打包成二进制数据，并带上 HiDPI 标志位，否则系统会把这条数据当成普通分辨率处理。
import plistlib import struct import base64 # 按你的显示器实际参数修改 vendor_id = 0x10AC product_id = 0xB240 # 想要开启的 HiDPI 逻辑分辨率，例如 1920x1080 width, height = 1920, 1080 # 大端序打包三个 32 位整数：宽、高、标志位 hidpi_data = base64.b64encode(struct.pack('>III', width, height, 1)) plist_data = { 'DisplayProductName': 'External Monitor', 'scale-resolutions': [hidpi_data], } output_path = f'DisplayProductID-{product_id:x}.plist' with open(output_path, 'wb') as f: plistlib.dump(plist_data, f) print(f'已生成 {output_path}')这段代码的核心是struct.pack('>III', width, height, 1)。>表示大端序，系统解析 plist 里的<data>字段时按大端序读取，顺序错了分辨率直接翻车；三个I分别是像素宽、像素高和标志位，标志位填 1 表示这是一个 HiDPI 档位。plistlib.dump默认输出 XML 格式的 plist，里面会自动把 bytes 编码成<data>节点，不用手工拼 Base64。
如果你只想加一个档位，这段脚本就够了。想加多个档位，就把scale-resolutions列表里多放几个hidpi_data，每个分辨率打包一次。脚本输出文件名用了product_id:x十六进制格式化，和上一步转换的 ID 保持一致。
3.3 第三步：把 plist 放入用户目录 Overrides
生成好 plist 之后，把它放到用户目录的指定位置。目录结构必须严格遵循DisplayVendorID-十六进制厂商ID/DisplayProductID-十六进制产品ID.plist的规则。
# 创建用户级 Overrides 目录 mkdir -p ~/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-10AC # 把生成的 plist 复制进去，文件名注意大小写 cp DisplayProductID-b240.plist ~/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-10AC/mkdir -p会一次性创建整条路径，即使中间目录不存在也不会报错。目录名DisplayVendorID-10AC中的10AC是厂商 ID 的十六进制，必须大写；文件名DisplayProductID-b240.plist里的b240是小写十六进制，DisplayProductID的 D 和 P 都要大写，plist 后缀必须小写。这个大小写差异是我踩过最多次的坑，系统对文件名大小写敏感，错了直接不加载。
复制完成后，不建议立刻重启。先检查文件能不能被系统正确解析，用 plutil 验证一遍格式：
plutil -lint ~/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-10AC/DisplayProductID-b240.plistplutil -lint是 macOS 自带的 plist 语法检查工具，输出OK说明格式没问题。如果报错，多数情况是 Python 写出来的 plist 里有特殊字符或编码问题，回到生成脚本重新跑一次。
3.4 第四步：注销重登并选择档位
配置放好后，注销当前用户再登录，让 WindowServer 重新读取显示配置。注销前保存好手头的工作，这一步会关闭所有图形界面程序。
# 保存所有工作后执行 osascript -e 'tell application "System Events" to log out'osascript调用系统事件触发注销流程，等几秒就会回到登录界面。重新登录后在系统设置的“显示器”面板里，应该能看到“缩放”列表多出了你注入的档位。选中 1920×1080（HiDPI）后，屏幕上的字体会立刻变锐利，整个桌面像是换了一块屏。
如果列表里没出现新档位，别急着怀疑脚本。先检查 ID 是否匹配、文件名大小写是否正确，再看 3.3 的 plutil 校验结果。ID 和路径全对的情况下，绝大多数是目录层级写错了，把Contents/Resources/Overrides中间任意一层拼错，系统就静默跳过，不报错也不提示。
4. 进阶调优：自定义缩放档位与字体渲染修复
4.1 增加更多档位与宽高比参数
一个档位不够用？那就批量生成。我的习惯是参考显示器面板的原生分辨率和物理宽高比，把常用的几个缩放档一次性写进 plist。比如 4K 16:9 面板，我会加 1920×1080、2560×1440 两档，有时加一个 1600×900 备用。
import plistlib import struct import base64 width, height = 1920, 1080 hidpi_data = base64.b64encode(struct.pack('>III', width, height, 1)) width2, height2 = 2560, 1440 hidpi_data2 = base64.b64encode(struct.pack('>III', width2, height2, 1)) plist_data = { 'DisplayProductName': 'External Monitor', 'scale-resolutions': [hidpi_data, hidpi_data2], } with open('DisplayProductID-b240.plist', 'wb') as f: plistlib.dump(plist_data, f)这里把两个档位都塞进数组，系统会按顺序显示在缩放列表里。注意宽高比必须和面板一致，16:9 面板塞 2560×1600（16:10）的档位，画面会被拉伸或者左右留黑边。带鱼屏用户更要小心，21:9 面板要算好 3440×1440 这类整数缩放关系，别拿 16:9 的数据硬套。
另一个容易忽略的点：不要迷信“越大越好”。HiDPI 档位的逻辑分辨率宜小不宜大，1920×1080 的逻辑分辨率在 4K 面板上是 2 倍缩放，清晰度和界面大小都很均衡；强行上 2560×1440 会让界面元素偏小，而且 Retina 屏的逻辑分辨率超过 200% 缩放时，某些应用的图标会重新采样，反而出现毛边。
4.2 字体发虚的排查与修复
注入档位后字体还是发虚，先确认你选中的到底是 HiDPI 档还是普通缩放档。系统设置里，HiDPI 档位的名字旁边通常会标注“看起来像 1920×1080”，而普通缩放档位只显示分辨率数字。选错档位是新手最容易犯的错，和配置文件没关系。
其次检查字体平滑设置。新系统里“字体平滑”选项默认是关闭的，但如果你从旧系统迁移过配置，或者装过第三方字体渲染工具，这个选项可能被打开，导致边缘出现诡异的发虚感。
defaults read -g AppleFontSmoothing这条命令读取全局字体平滑配置。如果返回值是1或2，说明被手动改过；想要关闭字体平滑，设置为 0 即可：
defaults write -g AppleFontSmoothing -int 0改了之后注销重登生效。字体发虚的另一个隐蔽来源是显示器的清晰度设置，很多 4K 显示器的出厂默认清晰度是 50%，在这种状态下无论开不开 HiDPI，文字边缘都有轻微白边。我一般把清晰度调到 60% 到 70%，再用系统自带校色走一遍，基本能消除。
4.3 批量处理多显示器与项目文件管理
同时挂两块外接屏时，手写 plist 容易乱。我的做法是把每个显示器的 VendorID、ProductID 和生成脚本放在同一个目录，用文件名区分。某次帮同事调三屏环境，我就是靠着这套命名规范，在系统升级后五分钟内把所有显示器配置全部恢复。
多显示器场景下，还可以利用脚本自动读取 ID，避免人工转换出错：
system_profiler SPDisplaysDataType | grep -E "VendorID|ProductID" | awk '{print $2}'awk '{print $2}'把VendorID: 4268里的数字单独抽出来，配合printf做进制转换，可以直接喂给 Python 脚本。这样一套下来，后续加显示器、换分辨率档位，都不用手动查文档。
5. 避坑与排查：开启 HiDPI 过程中最容易翻车的四个环节
5.1 重启后黑屏：原因与自救流程
现象：注入 plist 并重启后，外接显示器黑屏，系统没反应。
原因：误把不支持的宽高比写进了 scale-resolutions，或者标志位写错，导致系统尝试输出一个面板硬件不支持的分辨率，面板进入无信号状态。
解决：先把外接显示器拔掉，用 MacBook 自带屏幕启动。启动后把~/Library/Displays/Contents/Resources/Overrides/下刚放的 plist 移走，再插回显示器，注销重登。如果接的是不支持热插拔的老显示器，需要在拔掉外接屏的状态下完成登录，再插入显示器等待系统识别。我吃过一次亏之后，所有新档位都会先用 plutil 校验，再加到列表里。
5.2 系统大版本升级后 HiDPI 全部失效
现象：升级系统后进显示器设置，自定义档位全没了，分辨率列表回到默认状态。
原因：新版系统升级时会对显示配置目录做迁移，用户目录里的 Overrides 虽然还在，但新系统的显示服务不再读取旧格式的 scale-resolutions，或者字段校验规则变了。
解决：不用急着删配置，先打开 Overrides 目录看看文件是否还在。如果文件还在，说明是格式兼容问题，用新版系统重新生成一遍 plist 覆盖旧文件即可。这套手写方式的好处是恢复成本低，生成脚本还在，跑一遍就是全新配置。我从那以后每次升级系统前，都会把 Overrides 目录打包备份一份，升级完先对比差异再决定要不要重新生成。
5.3 改完不生效：SIP、签名与缓存问题
现象：plist 文件位置对、格式对、路径对，注销重登后系统设置里没有任何变化。
原因：新系统默认开启的完整性保护可能会拦截对显示配置的读取，尤其是从旧系统迁移过来的用户目录里可能带着旧权限；另一个可能是 WindowServer 缓存了旧配置，注销重登时没有重新扫描目录。
解决：先确认没有动过系统目录，我这套方案不需要关 SIP。然后检查文件属主和权限：
ls -l ~/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-10AC/文件属主应该是当前用户，权限至少是 644。如果属主显示为 root，用sudo chown $(whoami) 文件名改回来。缓存问题可以尝试删除 WindowServer 的显示配置缓存文件：
rm ~/Library/Preferences/com.apple.windowserver.plist删除后注销重登，系统会重建这份缓存。注意这个文件删了不影响系统稳定性，最多是窗口位置记忆会重置。如果删了还不行，多半是文件名大小写不对，回到 3.3 的检查清单逐项核对。
5.4 分辨率列表乱掉：重复档位与残留配置
现象：显示器设置里出现好几个相同分辨率，甚至同一分辨率出现两次，一个是 HiDPI 一个是普通缩放。
原因：之前用第三方工具配置过，工具生成的 plist 和手写的混在一起；或者系统目录里的残留 Overrides 也在生效，两边都提供了相同档位。
解决：打开用户目录和系统目录两个位置对比：
ls ~/Library/Displays/Contents/Resources/Overrides/ ls /System/Library/Displays/Contents/Resources/Overrides/系统目录那个不要动，除非你明确知道自己在做什么。把用户目录里自己写的 plist 重命名留底，只保留一份有效配置。清理完注销重登，列表就会恢复干净。这里有个识别残留的小技巧：凡是文件名里 ID 和你显示器实际 ID 对不上的，直接忽略，系统不会主动加载不匹配的文件。
6. 验证跑通：用截屏像素判断 HiDPI 是否真的生效
档位选上了，但怎么确认它真的生效？不能只看系统设置里的选项文字，我用两个办法验证，五分钟就能出结果。
第一个办法：截屏实测像素。选中你注入的 HiDPI 档位后，用系统自带的截屏命令抓一张全屏图：
screencapture -x /tmp/hidpi_check.png sips -g pixelWidth -g pixelHeight /tmp/hidpi_check.pngscreencapture把当前屏幕内容保存成图片，-x参数让截屏过程不播放提示音；sips读取这张图片的实际像素尺寸。如果你选的是 1920×1080 HiDPI 档，截出来的图片尺寸应该是 3840×2160，说明 2 倍缩放生效了。如果截出来是 1920×1080，说明你选的是普通缩放档，文字发虚一点都不冤枉。
第二个办法：用 system_profiler 查看系统报告的逻辑分辨率：
system_profiler SPDisplaysDataType | grep -E "Resolution|UI Looks Like"显示Resolution: 3840x2160配合UI Looks Like: 1920x1080 @ 2x时，就是标准的 HiDPI 状态。只要@ 2x字样出现，说明系统确实在以点对点方式渲染。这套验证逻辑我每次配置完都会强制走一遍，不只看选项，而是用截屏像素说话。
从那以后我每次配完显示器，第一件事就是截一张全屏图丢进 sips 看像素，已成条件反射。希望这篇笔记能帮到正被外接屏折磨的你——至少下次遇到系统升级后档位消失，你知道往哪个目录去翻救命的备份了。
本文还有配套的精品资源，点击获取
