命令行 on Xiang's Blog

Mac 命令行环境配置备忘

Thu, 07 May 2026 00:00:00 +0000

目的：把 Mac 上"终端里能用的工具从哪来、优先级如何、怎么自查"整理成一份备忘。

1. Git

当前 Git：git version 2.50.1 (Apple Git-155)
可执行位置：/usr/bin/git
来源：Apple / Xcode Command Line Tools（CLT）
CLT 路径：/Library/Developer/CommandLineTools

结论：

这是命令行工具，不是 GUI 应用，所以不会出现在「启动台」。
更新方式：随 macOS / Xcode / Command Line Tools 更新而更新（不是像 brew 那样单独升级）。

自查命令：

1
2
3

git --version
which git
xcode-select -p

2. Python / Conda

终端提示符有 (base)，conda 环境只有一个：

Conda 发行版：Miniforge（以 Cask 安装）
base 环境路径：/opt/homebrew/Caskroom/miniforge/base
当前默认 python/pip（因 PATH 优先级）：
- python → /opt/homebrew/Caskroom/miniforge/base/bin/python
- python3 → /opt/homebrew/Caskroom/miniforge/base/bin/python3
- pip → /opt/homebrew/Caskroom/miniforge/base/bin/pip
- pip3 → /opt/homebrew/Caskroom/miniforge/base/bin/pip3
系统也有：
- python3 → /usr/bin/python3
- pip3 → /usr/bin/pip3
- 但由于 conda 路径在 PATH 更前面，日常默认使用 conda 的 python/pip。

conda 的状态：

conda 在 shell 中既是一个函数（来自 ~/.zshrc），也有多个可执行文件路径。
这是 conda 初始化脚本的常见表现。

自查命令：

1
2
3

conda env list
conda list
type -a python python3 pip pip3 conda

3. Homebrew（命令行包管理器）

3.1 手动安装的顶层包

brew leaves 输出只有：

node
tree

这通常意味着：

真正"自己装来用"的命令行主工具基本就是 Node.js 和 tree
brew list 里看到的一大堆（cairo/pango/libpng/... 等）多为依赖库/被间接安装的组件

自查命令：

brew leaves
brew list
brew list --cask
brew uses --installed <包名>

3.2 Homebrew 是否"只在 base 环境里可用"？

不是。Homebrew 是系统级安装在 /opt/homebrew（Apple Silicon 常见路径）。在 base 环境也能用 brew/tree 的原因是：PATH 里包含 /opt/homebrew/bin。

验证命令：

type -a brew tree
which brew
which tree
conda deactivate
type -a brew tree

4. OrbStack（Docker / Kubernetes 命令来源）

PATH 里有 /Users/xiang/.orbstack/bin，该目录中包含：

docker
docker-compose
docker-credential-osxkeychain
kubectl
orb、orbctl

结论：当前的 docker / kubectl 很可能优先来自 OrbStack（取决于 PATH 排序）。

自查命令：

which docker
which docker-compose
which kubectl
type -a docker kubectl

5. PATH 优先级

当前 PATH（按优先级从高到低）：

/opt/homebrew/Caskroom/miniforge/base/bin ← conda base 的命令（python/pip 等）
/opt/homebrew/Caskroom/miniforge/base/condabin
/opt/homebrew/bin ← Homebrew 命令（brew、tree、node 等）
/opt/homebrew/sbin
/usr/local/bin
/System/Cryptexes/App/usr/bin
/usr/bin
/bin
/usr/sbin
/sbin
/opt/pmk/env/global/bin ← 非典型来源，可能是某个环境/工具链的全局 bin
/Library/TeX/texbin ← TeX/LaTeX 工具链（装了 mactex-no-gui）
/Users/xiang/.orbstack/bin ← OrbStack 的 docker/kubectl 等

重点记住：

谁在 PATH 前面，谁就"覆盖/优先"
目前：conda base 覆盖系统 python，brew 在其后；OrbStack 在较后但仍可用

快速查看某个命令到底来自哪里：

1
2

type -a <命令>
which <命令>

6. 与命令行相关的 GUI 应用（Homebrew Cask）

miniforge（决定 conda / base）
orbstack（提供 docker/kubectl 等）
mactex-no-gui（带来 /Library/TeX/texbin）
visual-studio-code（开发编辑器）

查看完整列表：

`1`	`brew list --cask`

7. “忘了装了啥"时的推荐排查顺序

先看 Homebrew 的"顶层包”：

`1`	`brew leaves`

再看 conda base 里装了什么（通常 python 相关在这里）：

1
2

conda list
python -m pip list

1
2
3

ls -1 /opt/homebrew/bin | head -n 80
ls -1 /opt/pmk/env/global/bin 2>/dev/null | head -n 80
ls -1 ~/.orbstack/bin 2>/dev/null | head -n 80

定位具体某个命令：

`1`	`type -a <命令>`

8. 关键结论一句话版

Git：Apple Git（CLT 提供，随系统/CLT 更新）
Python：主要来自 Miniforge conda base（覆盖系统 python3）
Brew 顶层工具：只剩 node、tree（其余多为依赖）
Docker/kubectl：很可能来自 OrbStack

终端网络代理配置手册

Thu, 07 May 2026 00:00:00 +0000

问题背景

macOS 的终端（Terminal / iTerm2）默认不走系统代理设置，导致 brew install、git clone、curl 等命令行工具无法连接 GitHub 或速度极慢。

解决方案很简单：在 Zsh 配置中注入几个别名，手动控制终端的代理开关。

配置代码

将以下代码块添加到 ~/.zshrc 的最底部：

# =================================================
# 终端代理控制 (Proxy Control)
# Target: Clash Verge (Localhost: 7897)
# =================================================

# 开启代理
alias proxy='export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897; echo "\n✅ 终端代理已开启 (Port: 7897)"'

# 关闭代理
alias unproxy='unset https_proxy http_proxy all_proxy; echo "\n🚫 终端代理已关闭"'

# 检查当前 IP
alias myip='curl -s ipinfo.io/json | grep -E "ip|country"'

生效步骤

打开配置文件：nano ~/.zshrc
将上述代码粘贴到文件末尾
保存退出（Ctrl+O → Enter → Ctrl+X）
立即生效：source ~/.zshrc

命令速查

命令	说明	预期反馈
`proxy`	开启代理，在 `brew install` 或 `git clone` 前使用	`✅ 终端代理已开启...`
`unproxy`	关闭代理，恢复国内直连	`🚫 终端代理已关闭...`
`myip`	验证当前出口 IP 及国家	`{ "ip": "x.x.x.x", "country": "US" }`

常见问题

端口变更

不同代理软件默认端口不同：

ClashX Pro：7890
Surge：6152
Clash Verge：7897

修改方法：打开 ~/.zshrc，将 alias proxy='...' 行中所有端口号替换为你的代理端口，然后 source ~/.zshrc 生效。

代理开启后依然超时

确认代理软件正在运行，且"系统代理"开关已打开
检查代理软件设置中的"混合端口 (Mixed Port)“是否与配置一致
执行 myip 确认出口 IP 是否已变化