macos脚本执行失败主因是系统安全机制拦截，需闭环检查权限（chmod +x）、隔离属性（xattr -d com.apple.quarantine）和完全磁盘访问权限（系统设置中授权终端），并确保shebang正确且用./方式执行。
macOS 安装软件时脚本执行失败，多数不是脚本本身有问题，而是系统安全机制在拦截。审计重点不在“能不能跑”，而在“为什么被拦”——关键看权限、隔离属性、访问控制三环是否闭环。
检查脚本是否具备可执行权限
macOS 默认不赋予 `.sh` 或其他脚本执行权，必须手动添加：
- 进入脚本所在目录，运行 chmod +x your-script.sh
- 如仅需当前用户可执行，用 chmod u+x your-script.sh 更稳妥
- 执行 ls -l your-script.sh 查看输出：首段含 x（如 -rwxr-xr-x）才表示权限已生效
确认是否被 macOS 隔离属性锁定
从网页、邮件或第三方渠道下载的脚本，会被自动打上 com.apple.quarantine 标记，即使有执行权也会报错：
- 运行 xattr -d com.apple.quarantine /path/to/your-script.sh（路径可直接拖入终端）
- 若提示 No such xattr，说明已无隔离属性，无需操作
- 再执行 ls -l@ your-script.sh，确认输出中不再出现该属性
验证终端是否获得完全磁盘访问权限
macOS Catalina 及之后版本限制终端读写桌面、文档、下载等目录，脚本中途可能卡在 Operation not permitted：
- 打开「系统设置 → 隐私与安全性 → 完全磁盘访问权限」
- 点击锁图标解锁，将 Terminal.app（或 iTerm2、VS Code 等你实际使用的终端）拖入列表
- 若终端未显示，可手动前往 /Applications/Utilities/Terminal.app 拖入
排查 shebang 与调用方式是否匹配
权限和隔离都正常，但脚本仍不执行？很可能是解释器没对上或启动方式绕过了关键机制：
- 确保脚本第一行是有效 shebang，例如 #!/bin/bash 或 #!/usr/bin/env bash
- 避免用 sh your-script.sh 启动——这会忽略 shebang，且可能用错 shell 环境
- 推荐统一使用 ./your-script.sh，前提是已完成 chmod +x
