编写 AppleScript 实现 macOS 自动投屏配置-Mac OS-PHP中文网

macos无原生自动投屏api，但可通过applescript结合system_profiler、defaults和displayplacer实现半自动镜像切换、主屏设定、usb触发检测及一键还原；需配合launchd轮询或热键调用，适用于ventura及以上系统。

macos 本身不提供直接的“自动投屏”系统级 api，但可通过 applescript 结合系统偏好设置、显示器管理命令和触发机制（如连接外接显示器时）实现半自动化的投屏配置。以下方案聚焦实用、稳定、无需第三方工具，适用于 macos ventura 及更新版本（含 sonoma）。

一、检测并切换到镜像模式（最常用场景）

当外接显示器接入后，脚本可自动将显示模式从“扩展”切为“镜像”，适合会议/演示前快速准备。

AppleScript 无法直接读取当前显示模式，但可通过 system_profiler SPDisplaysDataType 判断是否连接多显示器
使用 defaults write 修改镜像开关（需配合重启窗口服务器）
关键命令组合：

do shell script "defaults -currentHost write NSGlobalDomain AppleDisplayMirroringEnabled -bool true"
do shell script "killall -HUP WindowServer"

⚠️ 注意：此操作会短暂闪屏，且仅在系统设置中已启用“镜像显示器”选项时生效（需提前勾选一次）。

二、按显示器名称自动排列并设为主屏

若固定使用某台外接显示器（如“Dell U2723DX”），可脚本化设定其为主显示器并调整位置。

先用 system_profiler SPDisplaysDataType | grep 'Resolution\|Resolution:' 或 displayplacer list（需安装 displayplacer）获取设备 ID 或名称
推荐使用开源工具 displayplacer（轻量、无后台进程），通过 AppleScript 调用：

do shell script "displayplacer 'id:81926500-0000-0000-0000-000000000000 res:1920x1080 hz:60 color_depth:8 scaling:on origin:(0,0) degree:0' 'id:81926501-0000-0000-0000-000000000000 res:1920x1080 hz:60 color_depth:8 scaling:on origin:(1920,0) degree:0'"

? 提示：运行 displayplacer list 一次，复制对应显示器的完整 id 和参数，保存为变量或配置文件，便于复用。

Apple Silicon Ai

Apple Silicon AI — 在 Mac Studio、Mac Mini、MacBook Pro 和 Mac Pro 上运行大语言模型（LLM）、图像生成、语音转文字及嵌入（embeddings）。将您的 Apple Silicon 设备…

下载

三、结合 USB 设备接入触发自动执行

真正“自动”的关键在于事件监听。macOS 原生不支持显示器热插拔 AppleScript 事件，但可用以下替代方式：

Folder Action + I/O Kit 日志监控：监听 /var/log/system.log 中 “Display” 或 “IOFramebuffer” 相关条目（需 sudo 权限，较重）
更轻量推荐：用 launchd 定期检查显示器数量（每 5 秒）
创建 plist 放入 ~/Library/LaunchAgents/，调用一个 Shell 脚本，该脚本内嵌 AppleScript：

#!/bin/bash
count=$(system_profiler SPDisplaysDataType | grep -c "Resolution:")
if [ "$count" -gt "1" ]; then
  osascript -e 'do shell script "displayplacer ..."' 2>/dev/null
fi

四、一键恢复笔记本屏为主屏（退出投屏）

会议结束拔掉线缆后，常需还原为仅内置屏工作。可绑定快捷键（如 Cmd+Opt+P）执行：

关闭镜像：defaults -currentHost write NSGlobalDomain AppleDisplayMirroringEnabled -bool false
禁用外接屏（设分辨率 0×0）或移至负坐标隐藏
最稳妥方式：用 displayplacer 恢复预存的“仅内置屏”布局

do shell script "displayplacer 'id:... res:1680x1050 ... origin:(0,0)'"
do shell script "killall -HUP WindowServer"

✅ 建议将“投屏配置”和“还原配置”分别存为两个 .scpt 文件，再用 Alfred / FastScripts 绑定热键，体验接近一键切换。