localhost本地服务不使用.htaccess移除URL.html后缀的实现方法

你当前通过自定义server.js运行3000端口服务的场景，完全不需要依赖.htaccess即可实现需求。.htaccess是Apache HTTP Server专属的分布式配置文件，自有Node后端服务可以直接在请求处理逻辑层完成路径重写，不需要额外引入Apache相关配置。

方案1：在server.js中配置路径重写（推荐，无.htaccess依赖） #

核心逻辑是拦截所有不带文件后缀的GET请求，自动匹配对应路径下的.html文件返回，不需要修改原有静态文件的存储结构。

• 如果你用原生Node.js的http模块编写服务，直接替换/修改请求处理逻辑即可：

const http = require('http');
const fs = require('fs');
const path = require('path');
const PORT = 3000;
// 替换为你存放HTML/CSS/JS静态文件的实际目录
const STATIC_ROOT = path.join(__dirname, 'static');

const mimeMap = {
  '.html': 'text/html; charset=utf-8',
  '.css': 'text/css',
  '.js': 'text/javascript',
  '.png': 'image/png',
  '.jpg': 'image/jpeg',
  '.svg': 'image/svg+xml'
};

const server = http.createServer((req, res) => {
  // 根路径默认匹配index.html
  let targetPath = path.join(STATIC_ROOT, req.url === '/' ? '/index.html' : req.url);
  // 无后缀请求自动尝试匹配.html文件
  if (!path.extname(targetPath)) {
    const htmlMatchPath = `${targetPath}.html`;
    if (fs.existsSync(htmlMatchPath)) targetPath = htmlMatchPath;
  }
  // 响应文件
  const ext = path.extname(targetPath);
  fs.readFile(targetPath, (err, data) => {
    if (err) {
      res.writeHead(404, { 'Content-Type': 'text/plain' });
      res.end('404 Not Found');
      return;
    }
    res.writeHead(200, { 'Content-Type': mimeMap[ext] || 'application/octet-stream' });
    res.end(data);
  });
});

server.listen(PORT, () => {
  console.log(`服务已启动: http://localhost:${PORT}`);
});

• 如果你用Express框架编写server.js，实现逻辑更简洁：

const express = require('express');
const app = express();
const PORT = 3000;

// 拦截无后缀请求，重写到对应html文件
app.get(/^\/(?!.*\.[a-zA-Z0-9]+$).*/, (req, res, next) => {
  req.url = `${req.url}.html`;
  next();
});
// 托管静态资源目录，替换为你的实际静态文件目录
app.use(express.static('static'));

app.listen(PORT);

配置完成后重启服务，直接访问http://localhost:3000/index即可打开原index.html文件，页面内的跳转链接直接写无后缀路径即可，不会再暴露.html后缀。

方案2：.htaccess配置方法（仅适用于Apache环境，Node服务默认不生效） #

如果你后续改用Apache托管站点或做反向代理，可以按以下步骤配置.htaccess：

• 确保本地Apache服务已开启rewrite重写模块，Apache配置文件中对应站点的AllowOverride设置为All
• 在站点静态文件根目录新建名为.htaccess的文件（Windows系统无法直接新建点开头的文件，可以先创建txt文件写入内容后重命名）
• 在文件中写入以下重写规则：

RewriteEngine On
# 匹配非目录、非存在文件的请求，自动追加.html后缀
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^([^\.]+)$ $1.html [NC,L]

• 重启Apache服务后规则即可生效，访问无后缀路径会自动返回对应html文件。

内容的提问来源于stack exchange，提问作者BloxOverflow