macos 上 homebrew 与手动安装的软件可共存，但需注意路径优先级（如调整 path 使 /opt/homebrew/bin 在前）、避免同名命令冲突、gui 应用默认均安装至 /applications 而非真正共存、配置与数据目录可能重叠引发权限或版本问题、更新责任分离（brew 不管理手动文件）。
MacOS 上通过包管理器（如 Homebrew）安装的软件，和手动下载安装的版本（比如从官网拖拽到 Applications 文件夹的 .app，或解压后运行的命令行工具）可以共存，但需注意路径、优先级和配置冲突问题。
可执行文件路径冲突最常见
Homebrew 默认将命令行工具安装到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），而手动安装的 CLI 工具可能放在 /usr/local/bin、/opt/bin 或用户自定义目录（如 ~/bin）。Shell 启动时按 $PATH 顺序查找命令，靠前的路径中的同名程序会优先执行。
- 用 which command_name 或 type -a command_name 查看实际调用的是哪个版本
- 用 echo $PATH 确认路径顺序；若希望 Homebrew 版本优先，确保其 bin 目录在 PATH 中靠前（例如在 ~/.zshrc 中写成 export PATH="/opt/homebrew/bin:$PATH"）
- 手动安装的工具若覆盖了系统或 Homebrew 路径（如直接复制到 /usr/local/bin），可能被 Homebrew 更新或卸载时误删
GUI 应用（.app）基本互不影响
从官网下载的 App（如 VS Code、Postman、Docker Desktop）默认安装到 /Applications，而 Homebrew Cask 安装的同款应用也指向同一位置（brew install --cask visualstudiocode 实际也是把 .app 放进 /Applications）。它们本质是同一类分发方式，不是“共存”而是“同一来源不同安装途径”。
- 重复安装同名 App（比如先拖拽再用 cask 安装）通常会被覆盖或提示已存在
- Homebrew Cask 不管理 App 内部配置或用户数据，所以偏好设置、插件等不受影响
- 卸载时：brew uninstall --cask app-name 仅移除符号链接或调用卸载脚本，不一定清空全部数据（如 ~/Library/Application Support/ 下的内容需手动处理）
配置与数据目录可能重叠
某些软件（如 Node.js、Python、Redis）无论用 Homebrew 还是源码编译安装，都可能读取相同的配置路径（如 ~/.redis.conf）或数据目录（如 /usr/local/var/redis）。手动安装若复用了 Homebrew 创建的目录，容易引发权限或版本不兼容问题。
- Homebrew 服务类软件（brew services start redis）默认使用 /usr/local/var/xxx 存放数据；手动启动时应显式指定不同 --dir 或 --config 路径避免冲突
- 环境变量如 NODE_PATH、PYTHONPATH 若同时指向 Homebrew 和手动安装的 site-packages/lib，可能导致模块加载混乱
- 建议为手动安装的工具单独建立配置目录（如 ~/configs/redis-manual.conf），并在启动时明确传入
更新与维护责任分离
Homebrew 安装的软件可通过 brew update && brew upgrade 统一更新；手动安装的版本需自行跟踪发布、重新下载、替换文件。混合使用时，别误以为 “brew upgrade” 会更新你手动放进 /usr/local/bin 的二进制。
- Homebrew 不会扫描或管理非它安装的文件，哪怕路径相同
- 若手动替换了 Homebrew 管理的某个命令（如用新版本 curl 覆盖 /opt/homebrew/bin/curl），下次 brew upgrade curl 会把它改回来
- 需要长期使用特定手动版本？考虑用 brew pin xxx 锁定 Homebrew 版本，再把自定义二进制放到更高优先级路径（如 ~/local/bin 并置于 PATH 最前）
