一、基础准备：了解.sh脚本在macOS中的运行机制

.sh 文件是 Shell 脚本文件，通常用于自动化命令执行。在 macOS 中，默认的 Shell 从 bash 切换为 zsh（自 macOS Catalina 起），但大多数 .sh 脚本仍然兼容这两种 Shell。

.sh 文件本质上是一个文本文件，需要赋予可执行权限才能直接运行。脚本的第一行通常是 shebang 行（如：#!/bin/bash 或 #!/bin/zsh），用于指定解释器。若未正确设置 shebang，系统可能使用默认 Shell 来执行脚本，可能导致行为差异。

#!/bin/bash

echo "Hello, World!"

二、权限设置：赋予脚本可执行权限

在 macOS 上运行 .sh 文件前，必须确保该文件具有可执行权限。常见的做法是使用 chmod +x 命令。

打开终端（Terminal）。进入脚本所在目录，例如：cd ~/Downloads。执行权限修改命令：chmod +x script.sh。

验证权限是否生效：

ls -l script.sh

# 输出示例：-rwxr-xr-x 1 user staff 34 Oct 10 15:00 script.sh

三、执行方式：不同运行方法的区别与适用场景

执行方式命令示例说明直接执行./script.sh需先赋予可执行权限，适用于生产环境或部署脚本。通过 Shell 解释器执行bash script.sh 或 zsh script.sh无需权限，适合调试或临时运行。双击运行Finder 中双击仅当关联了正确的应用程序（如 Terminal）时有效，不推荐用于复杂脚本。

四、Shell 类型差异：bash vs zsh 的影响

macOS 自 Catalina 版本起将默认 Shell 从 bash 改为 zsh。虽然语法相似，但某些特性存在差异：

bash 和 zsh 在变量作用域、数组处理、别名扩展等方面略有不同。建议脚本中明确指定 shebang 行，以避免因默认 Shell 不同导致的问题。

#!/bin/zsh

echo "Running in zsh"

五、常见问题排查流程图

```mermaid

graph TD

A[开始] --> B{脚本是否有可执行权限?}

B -- 是 --> C{shebang 是否正确?}

C -- 是 --> D[尝试 ./script.sh 执行]

C -- 否 --> E[修改 shebang 行]

B -- 否 --> F[执行 chmod +x script.sh]

D --> G{执行失败?}

G -- 是 --> H[检查 PATH 环境变量]

G -- 否 --> I[成功运行]

```

六、进阶技巧：环境变量与路径配置

有时脚本依赖特定环境变量或路径配置。可通过以下方式优化执行环境：

在脚本开头显式设置 PATH：

export PATH=/usr/local/bin:$PATH

使用 source ~/.bash_profile 或 source ~/.zshrc 加载用户环境变量。使用绝对路径调用脚本或命令，避免路径错误。

/usr/local/bin/python3 /Users/user/scripts/myscript.py