MacOS 前后端开发环境搭建（mise + Docker）

说明：移除 SVN、VSCode、Flutter、iOS 模拟器；使用 mise 统一管理多语言 / 工具版本（node/java/python/go/maven）；mise 通过 Homebrew 安装；MySQL 等数据库全部跑在 Docker。

一、前置基础工具

1. Git（Mac 自带）

macOS 默认自带 Git，直接配置全局用户名邮箱

git config --global user.name "Boor"
git config --global user.email "gugol.boor@qq.com"

2. Homebrew 安装

国内镜像安装，速度更快

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

1. 源选择：清华大学源

2. 输入 Y 确认执行，过程需要输入开机密码

3. 提示 You have not agreed to the Xcode license agreements，执行：

xcode-select --install

按 Q 退出，跟随弹窗安装命令行工具。

安装完成重启终端，验证：

brew -v

常见报错

1. fatal: detected dubious ownership in repository

git config --global --add safe.directory /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core

2. 高版本 Mac 权限不足 Permission denied

sudo chown -R `whoami` /usr/local/Homebrew/
sudo chown -R $(whoami) $(brew --prefix)/*
sudo mkdir /usr/local/Frameworks
sudo chown -R `whoami` /usr/local/Frameworks/

二、终端美化 Oh-My-Zsh

1. 安装 Oh-My-Zsh

git clone https://github.com/robbyrussell/oh-my-zsh.git ~/.oh-my-zsh
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
echo "ZSH_DISABLE_COMPFIX=true" >> ~/.zshrc
chsh -s /bin/zsh

2. 命令高亮插件

sudo git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.zsh/zsh-syntax-highlighting
echo "source ~/.zsh/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" >> ~/.zshrc

3. 命令自动提示插件

sudo git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions
echo "source ~/.zsh/zsh-autosuggestions/zsh-autosuggestions.zsh" >> ~/.zshrc

4. 刷新配置

source ~/.zshrc

三、mise 版本管理器（统一管理 node /java/python /go/maven）

mise 用来统一管理开发工具版本，避免多版本冲突，使用 brew 安装。

1. 安装 mise

brew install mise

2. 配置 mise 到 zsh 环境

打开 zsh 配置文件

open ~/.zshrc

在文件末尾添加：

# mise 环境
eval "$(mise activate zsh)"

保存后刷新配置

source ~/.zshrc

3. mise 常用命令示例

# 安装指定版本
mise install node@16
mise install java@17
mise install python@3.11
mise install go@1.22
mise install maven@3.9.1

# 设置当前项目目录使用的版本（写入 .mise.toml）
mise use node@16
mise use java@17

# 设置全局默认版本
mise use -g node@16
mise use -g java@17

# 查看已安装工具
mise ls

# 查看当前环境
mise env

以后切换 node、java、go、python、maven 版本，直接用 mise 管理，不再手动配置环境变量。

4. pnpm /yarn 安装

node 装好后，直接用 npm 安装包管理器

npm install -g pnpm
npm install -g yarn
# 验证
pnpm -v

四、Docker（数据库全部容器化，MySQL 等在 Docker 内运行）

1. 安装 Docker Desktop

官网下载安装包：https://www.docker.com/products/docker-desktop/

Mac M 芯片 / Intel 芯片选择对应版本，安装后打开 Docker Desktop，等待启动完成。

验证是否安装成功

docker -v
docker compose -v

2. Docker 运行 MySQL 示例

# 启动MySQL容器
docker run -d \
  --name mysql8 \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=root123456 \
  -v ~/docker-data/mysql8:/var/lib/mysql \
  mysql:8.0

• -d 后台运行

• -p 3306:3306 端口映射

• MYSQL_ROOT_PASSWORD 设置 root 密码

• -v 数据持久化，容器删除数据不会丢失

# 进入mysql容器
docker exec -it mysql8 mysql -uroot -p

其他数据库（Redis、PostgreSQL）同样使用 Docker 部署。

五、常用工具

1. SwitchHosts

免费开源 hosts 管理工具，官网：https://swh.app/zh

2. Nginx 安装

brew install nginx

查看目录

open /usr/local/Cellar/nginx
open /usr/local/etc/nginx/

新建站点配置 servers/server.conf

server {
    listen       80;
    server_name  shturl.cc/c;

    location / {
        root   /Users/boor/Desktop/top_line/;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
}

hosts 绑定域名

127.0.0.1    shturl.cc/c

Nginx 常用命令

nginx                      # 启动
sudo nginx -s reload       # 修改配置重载
sudo nginx -s stop         # 快速停止
sudo nginx -s quit         # 优雅关闭
sudo nginx -t              # 检查配置是否错误

六、后端 IDE：IntelliJ IDEA

官网下载：https://www.jetbrains.com/idea/

JDK 由 mise 管理，IDEA 项目里直接选择 mise 安装的 JDK 版本即可。

七、Mac 开发常见问题

1. 软件提示文件已损坏无法打开

sudo spctl --master-disable

2. hosts 编辑出现 swap 文件提示 弹窗按 E 继续编辑，按 I 进入编辑模式；修改完成按 ESC，输入:wq!强制保存退出。