跨平台协作指南mac 本地搭建服务器环境搭建 与Windows Linux协同开发方法

1) 检查系统：macOS (建议 10.15+)；启用管理员权限。
2) 安装包管理器：打开终端，安装 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
3) 安装必要工具：Git、curl、vim：brew install git curl vim。

1) 本地安装适合轻量开发，命令直接运行，调试方便。
2) Docker 更利于跨平台一致性，推荐团队协作时使用 Docker Compose。
3) 决策建议：新项目优先 Docker，维护老项目或需原生性能时可本地安装。

1) 安装 Nginx：brew install nginx；启动：brew services start nginx；配置文件路径：/opt/homebrew/etc/nginx/nginx.conf（或 /usr/local/...）。
2) 安装 MariaDB：brew install mariadb；初始化并启动：brew services start mariadb；登录：mysql -u root。
3) 安装 PHP：brew install php@8.1（按需版本）；配置 Nginx 与 PHP-FPM，修改 nginx.conf 指向 /opt/homebrew/var/run/php-fpm.sock，重载 nginx：brew services restart nginx。

1) 启动：sudo apachectl start；停止：sudo apachectl stop。
2) 配置虚拟主机：编辑 /etc/apache2/httpd.conf，启用 PHP 模块并设置 DocumentRoot 指向项目目录。
3) 测试 PHP：在 DocumentRoot 放置 info.php 内容 ，在浏览器访问 http://localhost/info.php。

1) 安装 Docker Desktop（mac）：下载并安装，登录并启用。
2) 创建 docker-compose.yml（示例）包含 nginx、php-fpm、db、redis。保存项目根目录。
3) 运行：docker-compose up -d；查看容器：docker-compose ps；进入容器调试：docker-compose exec web bash。

1) 编辑 /etc/hosts，增加 127.0.0.1 myproject.local；保存后浏览器访问 myproject.local。
2) 如果使用 Docker，请确保 Nginx 容器监听 80，或使用 traefik/反向代理并在 hosts 指向宿主机 IP。

1) 使用 Git 管理代码，创建 .gitignore 忽略日志、vendor、node_modules 等。
2) 数据库迁移：使用迁移工具（Laravel 的 migrations、Flyway、Liquibase）提交迁移脚本而不是直接导出 SQL 文件。
3) 临时导入导出：mysqldump -u root -p dbname > dump.sql；远程导入：mysql -u user -p dbname < dump.sql。

1) 配置 .gitattributes：* text=auto eol=lf 保证仓库使用 LF。
2) 在 Windows 机器上设置 core.autocrlf=false（或 true 视团队约定而定），避免换行符导致冲突。
3) 文件权限：Unix 执行权限需在 mac/linux 设置 chmod +x；不要将可执行权限依赖存入 Windows。

1) 简单共享：使用 macOS 系统偏好 -> 共享 -> 文件共享，启用 SMB，Windows 通过 \\mac-host\share 访问。
2) 专业编辑：推荐 VSCode Remote - SSH 或 Remote - Containers，直接在容器/远程主机中编辑并调试。
3) 协作实时编码：VSCode Live Share 可跨平台多人实时协作，不需要共享文件系统。

1) Docker 情况：在 docker-compose.yml 中映射端口：ports: - "8080:80"；防火墙确保端口开放。
2) PHP Xdebug：在容器中安装并配置 Xdebug，把 client_host 设置为宿主机 IP（在 mac 使用 host.docker.internal）。
3) 浏览器调试：配置断点，确保 IDE 与 Xdebug 端口一致（通常 9003）。

1) 使用 CI（GitHub Actions/GitLab CI）跑测试、lint、构建镜像，确保每个平台的代码行为一致。
2) 在 CI 中用相同的 Docker Compose 或镜像来做集成测试，避免“本地可运行但线上失败”。
3) 把环境变量通过 .env.example 管理，不提交真实密钥。

1) 端口冲突：lsof -i :80 找出占用进程并停止。
2) 权限问题：查看文件属主与权限，使用 chown 和 chmod 修复。
3) 数据库连接失败：检查容器间网络，host 使用服务名（Docker）或宿主 IP（非容器）。

答：通过共享代码仓库（Git）+ 统一运行环境（Docker Compose 或相同的本地安装说明）。推荐维护 docker-compose.yml 和 .env.example，使用 VSCode Remote 或 SSH 远程到同一台测试机，或让每人运行相同的 Docker 镜像，从而保证一致性。

答：在仓库中添加 .gitattributes，统一 eol=lf，团队约定 core.autocrlf 设置；执行权限只在必要文件上设置，使用脚本在 CI 或启动时修正权限（例如 chmod +x scripts/*）。避免将平台相关的本地配置提交到仓库。

答：若团队成员多且有 Windows/Linux，优先选 Docker 以保证环境一致；若需要高性能或与宿主深度集成（如某些驱动），可选择本地安装并提供详尽的安装脚本与文档。混合策略：开发用 Docker，生产按需优化。

来源：跨平台协作指南mac 本地搭建服务器环境搭建 与Windows Linux协同开发方法