Mac OS 开发环境搭建指南 (PHP & Python)

一、基础工具安装

1. 安装 Homebrew (包管理工具)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，将 Homebrew 添加到 PATH：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

2. 安装 Git

brew install git

二、PHP 开发环境

1. 安装 PHP

brew install php

安装特定版本 (如 PHP 8.2):

brew install php@8.2

2. 切换 PHP 版本

brew unlink php && brew link php@8.2 --force

3. 安装 Composer (PHP 依赖管理)

brew install composer

4. 常用 PHP 扩展

pecl install xdebug
pecl install redis

三、Python 开发环境

1. 安装 Python

brew install python

安装特定版本 (如 Python 3.9):

brew install python@3.9

2. 管理 Python 版本 (推荐使用 pyenv)

brew install pyenv

添加到 shell 配置 (~/.zshrc 或 ~/.bashrc):

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc

安装特定 Python 版本:

pyenv install 3.9.13
pyenv global 3.9.13

3. 安装 pip (Python 包管理)

Python 3.4+ 已自带 pip，如需升级:

python -m pip install --upgrade pip

4. 虚拟环境管理

推荐使用 virtualenv 或 Python 内置 venv:

python -m venv myenv
source myenv/bin/activate

四、数据库安装

1. MySQL

brew install mysql
brew services start mysql

2. PostgreSQL

brew install postgresql
brew services start postgresql

3. Redis

brew install redis
brew services start redis

五、Web 服务器

1. Apache (Mac 自带)

sudo apachectl start

2. Nginx

brew install nginx
brew services start nginx

六、开发工具

1. 代码编辑器/IDE

• Visual Studio Code (推荐)
• PHPStorm (PHP 开发)
• PyCharm (Python 开发)

2. 数据库管理工具

• TablePlus
• Sequel Pro (MySQL)
• DBeaver (通用)

3. 其他工具

• Postman (API 测试)
• Docker (容器化开发)

七、环境配置检查

PHP 检查

php -v
composer --version

Python 检查

python --version
pip --version

数据库检查

mysql --version
psql --version
redis-cli ping

八、常见问题解决

1. 权限问题:

   • 使用 sudo 执行需要管理员权限的命令
   • 对于 brew 安装的服务，通常不需要 sudo

2. 端口冲突:

   • 检查端口占用: lsof -i :80
   • 杀死占用进程: kill -9 <PID>

3. 环境变量不生效:

   • 确保修改了正确的 shell 配置文件 (.zshrc 或 .bashrc)
   • 执行 source ~/.zshrc 或重新打开终端

4. 多版本切换问题:

   • 对于 PHP: 使用 brew link 和 brew unlink
   • 对于 Python: 使用 pyenv 管理多版本

按照以上步骤，您应该能够在 Mac OS 上搭建一个完善的 PHP 和 Python 开发环境。