ThinkPHP 本身不默认添加 .html 后缀，URL 中出现 .html 是因显式路由定义、伪静态误配、模板硬编码或中间件改写所致；TP6 无全局关闭开关，需从路由配置、Web 服务器规则及 URL 生成三处彻底拦截或移除。
ThinkPHP 本身不默认给路由加 .html 后缀，所谓“去除 HTML 后缀”，本质是：你或第三方规则主动加了它，或误配了伪静态规则，导致 ThinkPHP 把 /user/list.html 当作合法路径解析，而你其实并不想支持这个后缀。
为什么 URL 里会冒出 .html？
常见原因不是 ThinkPHP 自己加的，而是：
- 你在
route.php里显式定义了带.html的规则，比如Route::get('article/:id.html', 'index/article'); - Apache 或 Nginx 的伪静态配置错误地把所有以
.html结尾的请求都转发给了index.php，哪怕对应资源根本不存在 - 你启用了
URL_HTML_SUFFIX配置（仅 TP5.1 及更早版本支持），且设为了'.html'；TP6+ 已完全移除此配置项 - 前端模板中手写链接写了
.html，比如<a href="news/123.html">，而你没意识到这是硬编码
TP6 如何禁用 .html 后缀路由匹配
TP6 不再提供全局关闭 HTML 后缀的开关，但你可以从三处切断它：
- 检查
app/route.php，删掉所有含.html字样的Route::定义，尤其是通配规则如Route::any(':path+.html', 'index/index'); - 确认没有启用「域名绑定 + 后缀路由」组合，例如
Route::domain('m.example.com')->rule('.html', 'mobile/index'); - 如果使用了
think-orm或自定义中间件做路径预处理，检查是否在handle()中对$request->url()做了正则替换或重写
TP6 的路由解析默认只认路径段（/user/123），不会自动截掉 .html；一旦出现 .html 被匹配上，说明有显式规则在起作用。
立即学习“PHP免费学习笔记（深入）”；
Apache/Nginx 伪静态里别让 .html 漏进来
很多人以为只要 ThinkPHP 不配，.html 就不会生效——其实 Web 服务器层若放行，请求照样进到入口文件，然后被路由模块当作普通路径尝试匹配。
Apache 的典型错误写法（会导致 /xxx.html 进来）：
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
这规则不区分后缀，/user/list.html 会被原样传给 index.php/user/list.html，然后 ThinkPHP 尝试匹配该路径——若恰好有对应路由就命中，否则 404。这不是你想要的“优雅”，是失控。
正确做法是：在 RewriteRule 前加一条拦截，直接 404 或 301 去掉 .html：
RewriteCond %{REQUEST_URI} \.html$ [NC]
RewriteRule ^(.*)\.html$ /$1 [R=301,L]
<p>RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
Nginx 类似，加在 location / 块顶部：
if ($request_uri ~* "\.html$") {
return 301 $scheme://$host$1;
}
注意：$1 需配合 rewrite 捕获，更稳妥写法是：
rewrite ^/(.*)\.html$ /$1 permanent;
生成 URL 时别带 .html
如果你用 url() 或 Url::build() 生成链接，确保目标路由定义里不含 .html，且没开启任何后缀扩展插件。
TP6 默认生成的 URL 是干净的，例如：
url('user/read', ['id' => 123]) // → /user/read/id/123
但如果在 route.php 中这样写：
Route::get('article/:id', 'index/article')->ext('html');
那 url('index/article', ['id' => 123]) 就会输出 /article/123.html。去掉 ->ext('html') 即可。
另外检查是否误用了旧版 TP5 的 URL_HTML_SUFFIX 配置——TP6 中该配置已无效，留着只会造成误解。
真正要盯住的不是“怎么关掉 HTML 后缀”，而是“谁在往 URL 上贴这个后缀”：是路由定义、是伪静态、是模板硬编码，还是某个中间件悄悄改了请求路径。漏掉其中任意一环，.html 都会阴魂不散。
