thinkphp 8.0在windows 11安装报“mbstring extension is missing”或“class 'think\app' not found”，主因是cli环境未真正启用mbstring扩展：需用php --ini定位真实php.ini，php -r "var_dump(extension_loaded('mbstring'));"实测为true，并排除bom污染与runtime权限问题。
在Windows 11上执行composer create-project topthink/think myapp安装ThinkPHP 8.0时，终端直接报错“The mbstring extension is missing”，或运行php think run后提示Class 'think\App' not found——这不是Composer源问题，而是PHP命令行环境根本未加载mbstring扩展，导致框架自动降级或启动器无法解析中文路由与配置文件。
确认当前CLI调用的PHP是否真启用了mbstring
很多人改了php.ini却仍报错，是因为命令行调用的PHP和Web服务器用的不是同一个可执行文件，更不是同一份配置。
第一步：在PowerShell或CMD中执行php --ini，查看Loaded Configuration File路径；若显示php.ini-development或php.ini-production，说明你改的根本不是它——必须找到并编辑那个被实际加载的php.ini。
第二步：执行php -m | findstr mbstring，如果命令返回空，就证明扩展没加载；如果返回mbstring但后续仍报错，继续验证第三步。
第三步：运行php -r "var_dump(extension_loaded('mbstring'));"，输出必须是bool(true)才算真正生效。【注意：仅php -m看到mbstring不等于可用，必须用此命令实测】
Windows下启用mbstring的三类常见场景修复
方法一：XAMPP/WAMP用户
打开XAMPP控制面板 → 点击Apache右侧的Config → 选择PHP (php.ini) → 在文件中搜索;extension=mbstring，删掉前面的分号，改为extension=mbstring；保存后重启Apache服务。
方法二：phpEnv或手动解压版PHP
进入PHP安装目录（如D:\phpenv\php\php8.2.5），用记事本打开php.ini，确认extension_dir = "ext"指向正确，且该ext目录下存在php_mbstring.dll文件；取消;extension=mbstring注释，保存后关闭所有终端窗口，重新打开PowerShell再试。
方法三：系统PATH混杂多个PHP版本
执行where php，看列出几个路径；若不止一个，说明命令行调用的是旧版PHP。把新版PHP目录（如C:\php-8.2.5）移到PATH最前面，或临时在项目目录下用绝对路径运行：C:\php-8.2.5\php.exe -m | findstr mbstring验证。
验证通过后仍报mbstring缺失？检查runtime权限与BOM污染
这一步常被忽略：即使mbstring已加载，TP8在初始化时会读取config/app.php等含中文注释的配置文件，若文件保存为UTF-8 with BOM格式，PHP解析会失败并静默跳过mbstring依赖检测，最终仍抛出缺失错误。
用VS Code打开config/app.php → 右下角点击编码格式 → 选择“Save with Encoding” → 选“UTF-8 without BOM” → 保存。
同时检查runtime/目录是否对当前用户（如IIS_IUSRS或Users组）有写入权限；右键→属性→安全→编辑→勾选“修改”和“写入”。
最后执行php think clear清空缓存，再运行php think run。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
