双平台搭建thinkphp环境核心在于确保cli与web环境一致、路径处理可靠、配置加载无静默失败：需统一php版本及扩展，.env文件须utf-8无bom且置于根目录，路径拼接用directory_separator或正斜杠，runtime目录需手动创建并赋权。
双平台搭建ThinkPHP环境，核心不在“能不能装”，而在于CLI与Web环境一致、路径处理可靠、配置加载无静默失败。Windows和macOS底层差异（如路径分隔符、大小写敏感性、扩展加载机制）会让同一份代码在一台机器上正常，在另一台机器上直接中断——但这些问题都有明确解法，不难，只是容易被忽略。
确保PHP CLI与Web使用同一套配置
这是90%跨平台报错的根源：终端执行php -v显示8.1，浏览器里phpinfo()却显示7.4；或者composer create-project成功，但访问首页报“Class not found”。
- 先查CLI实际加载的php.ini：
php -i | grep "Loaded Configuration File"（Windows用findstr代替grep） - 确认该php.ini中已启用
extension=openssl、extension=pdo_mysql等关键扩展（Windows注意.dll后缀，macOS不用） - 若用XAMPP/WAMP/PHPStudy，必须在控制面板里单独设置“CLI PHP版本”，不能只改Apache/Nginx模块
正确处理.env文件与路径大小写
.env没生效？不是语法错，而是编码或位置不对；类找不到？大概率是macOS严格区分大小写，而Windows默认不区分。
windows-shell-syntax
下载
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
- .env必须放在项目根目录（与
think可执行文件同级），且编码为UTF-8 without BOM（VS Code右下角切换，Notepad++另存为时选“UTF-8”） - 类名与文件名保持一致大小写：如
app/controller/User.php对应appcontrollerUser，不能写成user.php或UserController.php混用 - 开发时统一用小写命名+PSR-4规范，CI流程中加校验脚本避免提交错误命名
路径拼接别硬写斜杠，用标准方式归一化
写'config/database.php'在Windows能跑，换到macOS可能因反斜杠解析异常而报错；写'app\model\User.php'在macOS又会因转义问题失效。
- 优先用
DIRECTORY_SEPARATOR拼接：$path = 'app' . DIRECTORY_SEPARATOR . 'model' . DIRECTORY_SEPARATOR . 'User.php'; - 简单场景可直接用正斜杠
/——PHP所有文件操作函数（include、fopen、realpath）都兼容，内核自动转换 - 涉及用户输入或外部路径时，先清理：
str_replace(['\', '/'], '/', $raw)，再用realpath()标准化
权限与运行时目录要手动初始化
Windows默认禁用runtime目录写入，macOS对storage目录权限更敏感，导致缓存写失败、日志无法生成，最终表现为“数据库连接失败”等假错误。
- 首次部署后，手动创建并赋权：
mkdir runtime && chmod 755 runtime（macOS/Linux）；Windows下右键目录→属性→安全→编辑→添加Users组“完全控制” - 不要依赖框架自动创建——ThinkPHP不会在
public/外自动建runtime，尤其Docker或Nginx配置不当易漏掉 - 检查
runtime/log/是否可写，比查数据库配置更早暴露环境问题
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
