macOS Shell环境变量怎么配置私有镜像仓库环境变量-Mac OS-PHP中文网

macos配置私有镜像需按工具分别设置：homebrew通过homebrew_*_git_remote和homebrew_bottle_domain环境变量指向清华等镜像；pnpm优先用~/.npmrc设registry，或导出pnpm_registry/ pnpm_config_registry；maven必须在settings.xml的中配置，不依赖环境变量。

在 macos 上配置私有镜像仓库相关的环境变量，核心是让工具（如 homebrew、pnpm、maven 等）能识别并优先使用你指定的私有源或国内镜像。不同工具依赖不同环境变量，不能一概而论，需按需设置。

Homebrew 私有/国内镜像源环境变量

Homebrew 从 2024 年起支持通过环境变量覆盖默认 Git 远程地址和二进制瓶（bottles）域名。这是最推荐的方式，比手动改 remote 更稳定、可复现：

在 ~/.zshrc（macOS Catalina 及以后默认）末尾添加：

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

保存后执行 source ~/.zshrc 生效
验证是否生效：cd "$(brew --repo)" && git remote get-url origin 应返回清华镜像地址

pnpm 私有 registry 环境变量与配置

pnpm 不依赖全局环境变量拉取包，但可通过环境变量控制行为，更常用的是 .npmrc 或命令行参数。若需统一强制走私有源，推荐组合使用：

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

设置 registry 环境变量（对 pnpm install 有效）：
export PNPM_REGISTRY="https://your-private-registry.com"

更可靠的方式：在项目根目录或用户主目录下创建 ~/.npmrc，写入：

registry=https://your-private-registry.com<br>
  //your-private-registry.com/:_authToken=xxx

若用 pnpm 7+，还可设 export PNPM_CONFIG_REGISTRY="https://..."，它会覆盖 .npmrc 中的 registry

Maven 私有镜像仓库环境变量与 settings.xml

Maven 本身不读取类似 MAVEN_REGISTRY 的环境变量，但可通过环境变量间接影响配置路径，实际镜像配置必须写在 settings.xml 中：

确保 M2_HOME 和 PATH 已正确配置（见知识库中 Maven 安装部分）
编辑 $M2_HOME/conf/settings.xml 或用户级 ~/.m2/settings.xml，在 <mirrors></mirrors> 节点内添加：

<mirror><id>private-maven</id><mirrorof>central</mirrorof><name>Private Nexus</name><url>https://nexus.your-company.com/repository/maven-public/</url></mirror>

如需认证，补充 <servers></servers> 节点，并用 mvn deploy 时自动读取

通用建议：Shell 配置文件选择与生效验证

macOS 默认使用 zsh，所有环境变量应写入 ~/.zshrc（非 ~/.bash_profile），除非你主动切换了 shell：

检查当前 shell：echo $SHELL → 应为 /bin/zsh
编辑配置：vi ~/.zshrc，末尾追加 export XXX=... 行
立即生效：source ~/.zshrc
验证是否加载成功：env | grep -i "registry\|brew\|maven" 或直接运行对应工具命令（如 brew info python、pnpm config get registry、mvn help:effective-settings）