Mac自动化神器osascript：从基础到实战

1. 为什么需要osascript控制Mac软件？

在Mac系统自动化领域，osascript是一个被严重低估的神器。作为AppleScript的命令行接口，它可以直接在终端执行AppleScript脚本，实现对GUI应用程序的精准控制。我曾在多个自动化项目中用它解决过这些典型问题：

• 批量处理场景：需要每天定时打开Photoshop处理上百张图片并导出指定格式
• 复杂工作流：开发调试时需要同时启动Web服务、数据库和前端调试工具
• 特殊权限操作：绕过某些应用的限制设置（如修改Safari默认下载路径）
• 无头环境控制：在SSH远程连接时操作本地GUI应用

与常见的Automator相比，osascript的优势在于：

1. 可编程性：支持条件判断、循环等完整编程结构
2. 可嵌入性：能直接集成到Shell脚本中
3. 精准控制：可以定位到具体菜单项和窗口元素

实际案例：我曾用3行osascript代码实现了iTerm2的自动化分屏+执行命令，比手动操作节省了80%的时间

2. osascript基础语法解析

2.1 基本命令结构

osascript执行有两种模式：

bash复制# 直接执行单行命令
osascript -e 'tell application "Finder" to open folder "Downloads"'

# 执行脚本文件
osascript /path/to/script.scpt

典型脚本结构包含三个关键部分：

applescript复制tell application "应用名"
    activate -- 激活应用
    -- 执行具体操作
end tell

2.2 常用对象模型

Mac应用通过AppleScript暴露的对象模型通常包括：

• application：应用本身
• window：窗口对象
• menu bar：菜单栏项
• document：文档对象

例如控制Safari的典型操作：

applescript复制tell application "Safari"
    make new document -- 新建标签页
    set URL of document 1 to "https://example.com"
    do JavaScript "alert('Loaded')" in document 1
end tell

2.3 特殊参数处理

当需要传递变量时，建议使用如下格式：

bash复制APP_NAME="Notes"
osascript <<EOF
tell application "$APP_NAME"
    activate
    show folder "工作"
end tell
EOF

避坑提示：包含特殊字符的参数必须用quoted form of转换：

applescript复制set filePath to quoted form of "/path/with spaces"

3. 典型应用场景实战

3.1 启动并配置开发环境

以下脚本实现一键启动完整开发环境：

applescript复制tell application "iTerm"
    activate
    tell current window
        create tab with default profile
        tell current session
            write text "cd ~/projects/main"
            write text "docker-compose up -d"
        end tell
        
        create tab with default profile
        tell current session
            write text "vim ~/projects/main/src/index.js"
        end tell
    end tell
end tell

tell application "Google Chrome"
    activate
    open location "http://localhost:3000"
end tell

3.2 自动化文件处理

批量重命名Finder中的文件：

applescript复制tell application "Finder"
    set targetFolder to folder "Downloads" of home
    set fileList to every file of targetFolder
    
    repeat with i from 1 to count of fileList
        set thisFile to item i of fileList
        set fileName to name of thisFile
        set newName to "backup_" & fileName
        set name of thisFile to newName
    end repeat
end tell

3.3 系统级操作

调节系统设置（需管理员权限）：

applescript复制do shell script "defaults write com.apple.dock autohide-delay -float 0" with administrator privileges
tell application "Dock" to quit

4. 高级技巧与调试方法

4.1 元素定位技巧

使用GUI Scripting前需要先启用：

applescript复制tell application "System Events"
    set UI elements enabled to true
end tell

定位具体UI元素的黄金组合：

1. 使用Accessibility Inspector（Xcode工具）
2. 录制Automator操作查看生成的AppleScript
3. 遍历层级结构：

applescript复制tell application "System Events"
    tell process "Safari"
        properties of every UI element of window 1
    end tell
end tell

4.2 错误处理机制

完善的错误处理模板：

applescript复制try
    tell application "Mail"
        set newMessage to make new outgoing message
        -- 更多操作...
    end tell
on error errMsg number errNum
    display dialog "错误 " & errNum & ": " & errMsg
    return
end try

4.3 性能优化建议

1. 减少activate调用：不必要的应用激活会显著降低速度
2. 使用with timeout避免卡死：

applescript复制with timeout of 30 seconds
    -- 长时间操作
end timeout

3. 批量操作时先禁用通知：

applescript复制tell application "System Events"
    set notifications enabled to false
    -- 执行操作...
    set notifications enabled to true
end tell

5. 与Shell脚本的集成实践

5.1 参数传递最佳实践

安全传参的推荐方式：

bash复制#!/bin/bash
APP_NAME=$1
WINDOW_TITLE=$2

osascript <<END
tell application "$APP_NAME"
    activate
    set windowList to every window whose name contains "$WINDOW_TITLE"
    if (count of windowList) > 0 then
        set bounds of first item of windowList to {100, 100, 800, 600}
    end if
end tell
END

5.2 条件执行模式

根据应用运行状态决定操作：

applescript复制tell application "System Events"
    set isRunning to exists (processes where name is "Xcode")
end tell

if isRunning then
    tell application "Xcode"
        quit
    end tell
else
    tell application "Xcode"
        activate
    end tell
end if

5.3 定时任务集成

通过launchd设置定时任务：

xml复制<!-- ~/Library/LaunchAgents/local.script.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>local.script</string>
    <key>ProgramArguments</key>
    <array>
        <string>osascript</string>
        <string>/path/to/script.scpt</string>
    </array>
    <key>StartCalendarInterval</key>
    <dict>
        <key>Hour</key>
        <integer>9</integer>
        <key>Minute</key>
        <integer>0</integer>
    </dict>
</dict>
</plist>

加载任务：

bash复制launchctl load ~/Library/LaunchAgents/local.script.plist

6. 常见问题解决方案

6.1 权限问题处理

遇到"Not authorized to send Apple events"错误时：

1. 前往系统设置 > 隐私与安全性 > 自动化
2. 勾选对应应用前的终端/iTerm权限
3. 对于命令行工具还需执行：

bash复制sudo touch /private/var/db/com.apple.xpc.launchd/disabled.allow

6.2 应用响应超时

调整应用响应超时设置：

applescript复制using terms from application "Safari"
    tell application "Safari"
        with timeout of 600 seconds
            -- 长时间操作
        end timeout
    end tell
end using terms from

6.3 特殊字符处理

处理包含引号的文本：

applescript复制set theText to quoted form of "This text has \"quotes\" inside"
do shell script "echo " & theText

7. 安全注意事项

1. 敏感信息保护：

applescript复制-- 错误方式（密码会出现在历史记录中）
do shell script "sudo command" with administrator privileges

-- 正确方式
do shell script "sudo command" with administrator privileges without altering line endings

2. 脚本签名验证：

bash复制codesign -dv --verbose=4 /path/to/script.scpt

3. 网络操作安全：

applescript复制tell application "Google Chrome"
    set URL of tab 1 of window 1 to "https://example.com"
    delay 2 -- 等待页面加载
    if title of tab 1 of window 1 contains "Error" then
        display alert "安全警告：页面加载异常"
    end if
end tell

在实际项目中，我建议将常用操作封装成函数库。例如这是我常用的窗口控制函数：

applescript复制on moveWindow(appName, x, y, width, height)
    tell application appName
        activate
        set bounds of front window to {x, y, x + width, y + height}
    end tell
end moveWindow

最后分享一个真实案例：某次需要批量处理500多个PDF文件，传统手动操作需要6小时，通过osascript结合Automator，最终实现全自动化处理，耗时仅15分钟。关键点在于正确处理Acrobat的文档对象模型和合理设置延迟时间。这再次证明了掌握osascript对提升Mac工作效率的巨大价值。