Automator调试指南 - Mac自动化教程

⚠️ 核心问题：静默失败

🚨 什么是静默失败？

Automator运行脚本时，如果出现错误，通常不会显示任何提示信息。脚本可能因为路径错误、依赖缺失、环境变量问题等原因失败，但Automator会"假装什么都没发生"，让你误以为脚本正常执行了。

常见原因

🔴 Python路径错误

脚本中指定的Python路径不存在或不可执行

🔴 依赖包缺失

Python环境中缺少必需的第三方库

🔴 环境变量丢失

Automator找不到brew安装的工具（如poppler）

🔴 权限问题

脚本没有执行权限或访问目标文件夹的权限

🔍 三步排查法

1

验证Python路径

首先确认你的电脑上Python的真实路径：

# 查看系统默认Python路径
which python3

# 如果使用conda，查看conda环境中的Python
which python

# 查看所有Python版本
which -a python python3

你会得到类似这样的输出：

/usr/local/bin/python3
# 或
/Users/你的用户名/miniconda3/bin/python
# 或
/Users/你的用户名/anaconda3/bin/python

💡 重要

复制这个路径，回到Automator脚本，找到第一行PYTHON_EXEC="..."，将引号内的内容替换为你刚才复制的真实路径。

2

终端"照妖镜"测试

Automator会吞掉错误信息，我们得在终端里手动运行脚本：

创建一个测试脚本test_debug.sh：

# ⚠️ 替换为你第一步找到的真实路径！！
PYTHON_EXEC="/Users/你的用户名/miniconda3/bin/python"

"$PYTHON_EXEC" <<'EOF'
import sys
try:
    from pypdf import PdfReader
    print("✅ pypdf库加载成功！")
except ImportError:
    print("❌ 错误：找不到pypdf库")
    sys.exit(1)

import subprocess
try:
    subprocess.run(
        ["pdftoppm", "-h"],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL
    )
    print("✅ Poppler工具检测成功！")
except FileNotFoundError:
    print("❌ 错误：找不到Poppler，请运行 brew install poppler")
EOF

在终端运行测试：

bash ~/Desktop/test_debug.sh

📋 结果判断

✅ 两个都成功：环境配置正确，问题可能在Automator设置
❌ 找不到pypdf：运行pip install pypdf
❌ 找不到Poppler：运行brew install poppler

3

添加错误日志

在脚本中添加日志功能，错误信息会写入桌面：

import sys
import os
from pathlib import Path

def log_error(msg):
    """错误日志会保存到桌面"""
    desktop = Path.home() / "Desktop" / "automator_error.log"
    with open(desktop, "a") as f:
        f.write(f"{msg}\n")

def main():
    try:
        # 你的主要代码
        pass
    except Exception as e:
        log_error(f"Error: {str(e)}")
        # 同时发送系统通知
        os.system(f'osascript -e \'display notification "详情请查看桌面日志" with title "脚本出错"\'')

🌍 环境变量配置

⚠️ 关键问题

Automator运行脚本时，是一个"裸机"环境。它不会读取你的.zshrc或.bash_profile。这意味着brew安装的工具（如poppler）找不到，因为它们不在默认PATH中。

解决方案：手动注入环境变量

在Automator的Shell脚本最顶端添加以下代码：

# =======================================================
# 强制注入环境变量（这是之前失败的关键原因）
# =======================================================
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"

# Intel芯片Mac用这个：
# export PATH="/usr/local/bin:$PATH"

# Apple芯片Mac用这个：
# export PATH="/opt/homebrew/bin:$PATH"

# 其余脚本...

💡 如何判断芯片类型？

运行uname -m命令：
x86_64 = Intel芯片
arm64 = Apple芯片（M1/M2/M3）

⚙️ Automator设置检查

快速操作设置清单

设置项	推荐值	说明
工作流程收到	`PDF文件`	不要选"文件或文件夹"
位于	`访达.app`	确保在Finder中可用
Shell	`/bin/bash`	或/bin/zsh
传递输入	`作为自变量`	接收文件路径

✅ 调试清单

✓ Python路径已验证并更新
✓ 依赖包已在对应Python环境中安装
✓ 环境变量已手动注入（如需brew工具）
✓ 终端测试脚本运行成功
✓ Automator设置符合推荐配置
✓ 已添加错误日志功能