需启用mod_rewrite模块、设置DocumentRoot指向public目录、在public下放置正确.htaccess文件，三者缺一不可；否则ThinkPHP路由无法接管请求，导致除首页外全部404。
phpEnv 一键部署 FastAdmin 后，首页能打开但点任何菜单都 404 —— 这不是代码问题，是伪静态没生效。FastAdmin 基于 ThinkPHP 路由机制，所有非静态资源请求必须经 index.php 入口分发，否则控制器根本收不到请求。
确认 phpEnv 是否已启用 mod_rewrite
phpEnv 默认集成 Apache，但 mod_rewrite 模块未必默认开启。不检查这一步，后面所有规则都白配。
- 打开 phpEnv 控制面板 → “Apache” → “模块管理”，勾选
rewrite_module并重启 Apache - 或手动编辑
phpenv\apache\conf\httpd.conf，取消注释这一行：LoadModule rewrite_module modules/mod_rewrite.so - 同时确认虚拟主机配置中允许重写：
AllowOverride All（不能是None）
根目录 .htaccess 文件必须存在且内容正确
phpEnv 的 Apache 默认读取根目录下的 .htaccess，FastAdmin 安装后不会自动生成它，必须手动创建。
- 在项目根目录（即含
public/和application/的那层）新建文件，命名为.htaccess（注意开头是英文点号） - 内容严格使用以下规则（ThinkPHP 5.1 兼容版，FastAdmin 实际依赖此格式）：
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L] - 不要用网上流传的
/index.php?/$1或/index.php?s=/...$1变体，s=$1是 ThinkPHP 5.1 的标准参数名，错一个字符就 404
phpEnv 虚拟主机 DocumentRoot 必须指向 public 目录
FastAdmin 推荐将 Web 根目录设为 public/，而非项目根目录。如果 phpEnv 的站点根目录仍指向项目顶层（如 D:\phpenv\www\fastadmin\），.htaccess 会被忽略，因为入口文件 index.php 不在 Web 可访问路径下。
- 在 phpEnv 控制面板 → “网站管理” → 编辑你的站点 → 将“网站根目录”改为
D:\phpenv\www\fastadmin\public（Windows）或对应路径 - 同时把刚才写的
.htaccess移到public/目录下（不是项目根目录） - 检查
public\index.php中的define('BIND_MODULE', 'index');等定义是否完整，别被误删
访问时 URL 不能带 index.php，否则伪静态失效
即使规则全对，如果浏览器地址栏里还带着 index.php（比如 http://localhost/index.php/admin），说明重写根本没触发 —— 这通常是因为前面三步中某处断了链。
- 测试方式：直接访问
http://localhost/admin（不带index.php），看是否进后台；若仍 404，检查 Apache 错误日志（phpenv\apache\logs\error.log），搜索 “Rewrite” 或 “No input file specified” - 常见干扰项：
application\config.php中的'url_route_must' => true开启时，未定义的路由会直接报错，建议初期设为false排查 - 伪静态生效后，
addon_url()等函数生成的链接才自动去掉index.php，反之说明底层重写未接管请求
最易被忽略的是 .htaccess 放错位置：它必须在 public/ 目录下，且 DocumentRoot 必须指向该目录。这两者不匹配，其他所有配置都只是纸上谈兵。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
