ThinkPHP 在 Apache 环境下部署，.htaccess 文件几乎是必不可少的一环。核心原因很简单：不配好它，你的所有 URL 里都会带着碍眼的 index.php，而且框架的路由系统也基本等于没工作。
一句话总结：ThinkPHP 在 Apache 下必须用 .htaccess 实现 URL 重写，否则 index.php 会暴露在所有 URL 中，且路由完全失效。
确认 mod_rewrite 已启用且 AllowOverride 允许重写
不少 ThinkPHP 部署失败，仔细一查，往往并不是代码逻辑本身的问题，而是 Apache 服务器压根没给 .htaccess 文件“执行”的权利。仅仅启用 mod_rewrite 模块还不够，还必须确保对应的目录允许读取并执行这里的覆盖配置。
- 在 Ubuntu/Debian 系统上，可以运行
a2enmod rewrite；在 CentOS 上，则要去检查httpd.conf配置文件，确保LoadModule rewrite_module modules/mod_rewrite.so这一行没有被注释掉。 - 找到虚拟主机或者主配置文件中，对应你项目根目录的那个
/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 脚本处理即可，不要把它当成一次新的内部重定向再从头执行一遍规则。如果没有PT，ThinkPHP 的$_SERVER['PATH_INFO']会变为空，路由解析直接就崩了。- 另外，千万别画蛇添足地加上
R（外部跳转）标志，或者随意改动L（Last）标志，这会破坏框架对原始请求路径的感知。
常见报错与绕过方式
即使 .htaccess 内容写对了，也有可能因为环境限制而失败。遇到 500 错误，或者 URL 里依旧带着 index.php 的 404 报错，可以按这个思路排查：
- 服务器返回
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”，否则系统会自动给它加上.txt后缀。 - 用 VS Code、Notepad++ 这类代码编辑器创建时，在保存窗口的“保存类型”里选择“所有文件”，文件名直接填
.htaccess即可。 - 上传到 Linux 服务器后，记得用
ls -la命令确认文件是否存在。如果显示为htaccess（没有点）或者.htaccess.txt，说明上传时文件被自动改名了。这时需要用 FTP 软件的“重命名”功能手动修正过来。 - 另外，某些共享主机会强制要求
.htaccess文件必须放在网站根目录，放在子目录里是无效的。如果你的 ThinkPHP 项目部署在子目录下（比如https://example.com/myapp/），还需要在.htaccess里额外加上一句RewriteBase /myapp/。
总结一下，配置 .htaccess 真正卡住人的地方，往往不是规则本身有多复杂，而是 Apache 的配置层级和文件系统权限之间的隐式耦合。一个 .htaccess 文件要最终生效，需要同时满足“被读到”、“被信任”、“被正确解析”这三个条件，缺一不可。
