refactor(core): ♻️ 更新 PATH 环境变量并补充 brew doctor 说明

在引导脚本的 PATH 变量中增加 Homebrew 的 sbin 路径,以解决常见的路径缺失
警告。同步更新 README 文档,增加了关于 brew doctor 警告的处理指南,包括
如何处理废弃的 Cask 以及手动配置 PATH 的详细步骤。
This commit is contained in:
2026-05-08 02:03:28 +08:00
parent c869660a5a
commit 4a97c1cb4a
2 changed files with 31 additions and 1 deletions

View File

@@ -197,6 +197,36 @@ HB_TERMINAL_WIDTH=130 brewup
通常是网络、Homebrew tap 或权限问题。先确认 Homebrew 可正常访问 GitHub 和对应 tap。 通常是网络、Homebrew tap 或权限问题。先确认 Homebrew 可正常访问 GitHub 和对应 tap。
### `brew doctor` 提示 warning
`brew doctor` 的 warning 不一定代表脚本失败。脚本会继续执行,并打印:
```bash
Warning: 'brew doctor' detected issues. Manual review and resolution are recommended.
```
常见 warning 处理方式:
- `Some installed casks are deprecated or disabled`:说明某些 Cask 已废弃或被禁用,例如 `ayugram`。可以自行寻找替代应用,或不再需要时卸载:
```bash
brew uninstall --cask ayugram
```
- `Homebrew's "sbin" was not found in your PATH`:说明 shell 的 PATH 缺少 Homebrew 的 sbin 目录。Apple Silicon Mac 通常可加入:
```bash
echo 'export PATH="/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
Intel Mac 或 `/usr/local` 安装的 Homebrew 可加入:
```bash
echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
## 注意事项 ## 注意事项
- 脚本启用了 `set -e` 和 `set -o pipefail`,关键命令失败会终止流程。 - 脚本启用了 `set -e` 和 `set -o pipefail`,关键命令失败会终止流程。

View File

@@ -11,7 +11,7 @@ cleanup() {
} }
trap cleanup EXIT INT TERM trap cleanup EXIT INT TERM
PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" PATH="/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin"
export PATH export PATH
setup_sudo_askpass() { setup_sudo_askpass() {