ThinkPHP在Apache下必须配置.htaccess实现URL重写，否则index.php暴露且路由失效；需启用mod_rewrite模块、将对应目录的AllowOverride设为All，并确保.htaccess置于public目录下，规则中RewriteEngine On和PT标志不可或缺。
ThinkPHP 在 Apache 下必须用 .htaccess 实现 URL 重写，否则 index.php 会暴露在所有 URL 中，且路由完全失效。
确认 mod_rewrite 已启用且 AllowOverride 允许重写
很多 ThinkPHP 部署失败，根本不是代码问题，而是 Apache 没给 .htaccess 执行权限。光启 mod_rewrite 不够，还必须让目录允许覆盖配置。
- 运行
a2enmod rewrite（Ubuntu/Debian）或检查httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so是否已取消注释 - 找到对应虚拟主机或主配置中
<Directory>块（通常是/var/www/html或你的项目根目录），把里面的AllowOverride None改成AllowOverride All - 注意：Apache 配置里可能有多处
AllowOverride None，只改你项目所在目录的那一个；改错位置会导致重写静默失败 - 改完必须重启 Apache：
systemctl restart apache2（Ubuntu）或systemctl restart httpd（CentOS）
ThinkPHP 标准 .htaccess 内容及关键点
ThinkPHP 官方推荐的根目录 .htaccess 内容极简，但每行都有不可省略的作用：
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
-
RewriteEngine on是开关，缺了整段规则不生效 - 两个
RewriteCond合起来意思是「如果请求的路径不是真实存在的目录，也不是真实存在的文件」——这是防止静态资源（如/static/css/app.css）被错误转发到index.php -
RewriteRule最后参数里的PT（PassThrough）很关键：它让 Apache 把重写后的 URL 交给 PHP 脚本处理，而不是当成内部重定向再走一遍；没有它，ThinkPHP 的$_SERVER['PATH_INFO']会为空，路由解析直接崩 - 别手欠加
R（外部跳转）或改L（Last）为其他 flag，会破坏框架对请求路径的原始感知
常见报错与绕过方式
即使 .htaccess 写对了，也可能因环境限制失败。遇到 500 错误或 404 仍带 index.php，先看这些：
立即学习“PHP免费学习笔记（深入）”；
- 服务器返回
500 Internal Server Error并日志里有Invalid command 'RewriteEngine'→mod_rewrite没启用或没加载成功 - URL 显示
index.php/home/index但页面空白 →AllowOverride仍是None，.htaccess被完全忽略 - 图片/CSS/JS 404 → 两个
RewriteCond缺失或写错，导致所有请求都进了index.php，静态资源无法命中 - 虚拟主机托管（如国内小厂空间）明确禁用
.htaccess→ 只能改用 Nginx，或退而求其次，在入口index.php顶部手动解析$_SERVER['REQUEST_URI']模拟 PATH_INFO（不推荐，兼容性差）
Windows 下创建和上传 .htaccess 的实际坑
Windows 资源管理器默认不允许创建以点开头的文件名，直接右键新建会失败：
- 用记事本另存为时，文件名必须用英文引号包住：
".htaccess"，否则 Windows 自动补上.txt - 用 VS Code、Notepad++ 等编辑器创建时，保存类型选「所有文件」，文件名填
.htaccess即可 - 上传到 Linux 服务器后，用
ls -la确认文件存在且权限为644；若显示为htaccess（无点）或.htaccess.txt，说明上传过程被自动改名，需用 FTP 工具的「重命名」功能手动修正 - 某些共享主机强制要求
.htaccess必须放在网站根目录，子目录放无效；ThinkPHP 若部署在子目录（如https://example.com/myapp/），还需额外加RewriteBase /myapp/
真正卡住人的往往不是规则本身，而是 Apache 配置层级和文件系统权限的隐式耦合——.htaccess 生效的前提，是它被读到、被信任、被正确解析，三者缺一不可。
