
1. 为什么需要专门配置Mac开发环境作为从Windows/Linux转战macOS的程序员我花了整整两周才把开发环境折腾顺手。macOS的Unix基因让它天生适合开发但默认配置远不能满足专业需求。比如缺少包管理工具类似apt/yum命令行工具版本陈旧Git 2.15 vs 最新2.40开发工具链不完整需要手动装Xcode CLT更头疼的是权限管理机制。第一次用sudo安装Python包时我就遇到了Operation not permitted错误——这是macOS特有的SIPSystem Integrity Protection机制在作祟。后来发现正确的做法是# 错误示范 sudo pip install numpy # 正确做法使用--user参数 pip install --user numpy2. 基础工具链配置2.1 必装神器HomebrewHomebrew是macOS的缺失的包管理器。安装时有个坑官方脚本需要访问GitHub国内用户可能会卡住。我推荐用国内镜像源安装# 使用中科大镜像 /bin/bash -c $(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install.sh)安装后需要配置环境变量。在~/.zshrcCatalina之后默认shell添加export HOMEBREW_API_DOMAINhttps://mirrors.ustc.edu.cn/homebrew-bottles/api export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.ustc.edu.cn/homebrew-bottles export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.ustc.edu.cn/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.ustc.edu.cn/homebrew-core.git2.2 终端环境升级macOS自带的Terminal.app功能孱弱。我强烈推荐iTerm2 Oh My Zsh组合# 安装iTerm2 brew install --cask iterm2 # 安装Oh My Zsh sh -c $(curl -fsSL https://raw.fastgit.org/ohmyzsh/ohmyzsh/master/tools/install.sh)配置Powerlevel10k主题后我的终端变成了这样# 安装字体解决图标显示问题 brew tap homebrew/cask-fonts brew install --cask font-meslo-lg-nerd-font # 安装主题 git clone --depth1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k3. 开发语言环境配置3.1 Python多版本管理macOS自带的Python2.7早已淘汰。用pyenv管理多版本更高效brew install pyenv # 安装最新Python pyenv install 3.11.4 # 设置全局默认 pyenv global 3.11.4遇到zlib not available错误时需要先安装依赖brew install zlib export LDFLAGS-L/usr/local/opt/zlib/lib export CPPFLAGS-I/usr/local/opt/zlib/include3.2 Node.js环境配置前端开发推荐用nvm管理Node版本curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash在.zshrc中添加export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node安装LTS版本nvm install --lts nvm use --lts4. IDE与开发工具4.1 VS Code高效配置安装VS Code后必装插件Python IntelliSensePython智能提示ESLintJavaScript语法检查Docker容器开发支持Remote - SSH远程开发关键配置settings.json{ editor.fontFamily: MesloLGS NF, python.linting.pylintEnabled: false, python.linting.flake8Enabled: true, editor.formatOnSave: true }4.2 数据库工具选型MySQL开发推荐Sequel Pro的开源分支Sequel Acebrew install --cask sequel-aceRedis可视化工具Another Redis Desktop Managerbrew install --cask another-redis-desktop-manager5. 效率工具推荐5.1 窗口管理神器Rectangle替代收费的Magnet免费开源brew install --cask rectangle配置快捷键⌥⌘←左半屏⌥⌘→右半屏⌥⌘↑全屏5.2 剪贴板历史工具Maccy比Paste更轻量brew install --cask maccy建议设置快捷键设为⌥V忽略密码管理器内容安全考虑6. 避坑指南6.1 解决brew update慢的问题修改~/.zshrcexport HOMEBREW_BOTTLE_DOMAINhttps://mirrors.ustc.edu.cn/homebrew-bottles export HOMEBREW_NO_AUTO_UPDATE16.2 处理macOS系统更新导致的开发工具失效每次系统大版本升级后重装Xcode命令行工具xcode-select --install重建brew依赖brew doctor brew missing6.3 外接显示器字体发虚问题这是macOS的HiDPI机制导致解决方案# 安装RDM brew install --cask avibrazil-rdm # 选择带⚡️的分辨率7. 我的.zshrc配置分享最后分享我的完整配置# Homebrew export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.ustc.edu.cn/homebrew-bottles export PATH/usr/local/bin:$PATH # Pyenv export PYENV_ROOT$HOME/.pyenv export PATH$PYENV_ROOT/bin:$PATH eval $(pyenv init --path) # Nvm export NVM_DIR$HOME/.nvm [ -s /usr/local/opt/nvm/nvm.sh ] . /usr/local/opt/nvm/nvm.sh # Aliases alias llls -alF alias grepgrep --colorauto alias brewupbrew update brew upgrade brew cleanup