先确认源码类型
拿到源码先看根目录文件。出现 package.json 说明是 Node 项目；有 composer.json 多为 PHP 项目；requirements.txt 或 manage.py 则是 Python 项目。不同技术栈对应的本地环境工具完全不同，这一步决定后续所有操作。
选择本地集成环境
不想手动装 Nginx、PHP、MySQL，可以用集成工具：
- PHP 项目：phpStudy、XAMPP、MAMP
- 通用容器：Docker + docker-compose
- 前端项目：Node.js + npm/yarn 即可
Docker 的可移植性最好，团队协作时推荐优先考虑。
部署源码与配置站点
将源码放入集成环境的网站根目录（如 www 或 htdocs）。在管理面板新建站点，绑定域名如 test.local，并指向源码目录。
接着复制配置文件：把 .env.example 改名为 .env，或把 config.sample.php 改为 config.php，再按本地情况填写数据库账号、密码和站点地址。
导入数据库
在集成环境中新建一个空数据库，字符集建议 utf8mb4。用 phpMyAdmin 或命令行导入源码自带的 .sql 文件：
mysql -u root -p 数据库名 < backup.sql
导入后检查 .env 中的数据库名、用户名、密码是否与本地一致。
安装依赖与初始化
根据项目类型执行对应命令：
- Node 项目：
npm install后npm run dev - PHP 项目：
composer install - Python 项目：
pip install -r requirements.txt
部分系统还需运行迁移命令或访问 /install 完成初始化。
常见报错排查
页面空白先开 PHP 错误显示或查看浏览器控制台；数据库连接失败检查端口是否为 3306；伪静态不生效需在集成环境中启用对应 rewrite 规则；权限报错则给 storage、runtime 等目录写权限。
小结
搭建本地环境的核心顺序是：识别技术栈、准备运行环境、放置源码、配置连接信息、导入数据、安装依赖。按这个流程走，多数网站源码都能在本地顺利跑起来。
