# 静态文件

要提供静态文件,例如图像、CSS 文件和 JavaScript 文件,请使用 Express 中的 express.static 内置中间件函数。

函数签名是:

express.static(root, [options])

root 参数指定提供静态资产的根目录。有关 options 参数的更多信息,请参阅 express.static

例如,使用以下代码在名为 public 的目录中提供图像、CSS 文件和 JavaScript 文件:

app.use(express.static('public'))

现在,您可以加载 public 目录中的文件:

http://localhost:3000/images/kitten.jpg
http://localhost:3000/css/style.css
http://localhost:3000/js/app.js
http://localhost:3000/images/bg.png
http://localhost:3000/hello.html

Express 查找相对于静态目录的文件,因此静态目录的名称不是 URL 的一部分。

要使用多个静态资产目录,请多次调用 express.static 中间件函数:

app.use(express.static('public'))
app.use(express.static('files'))

Express 按照您使用 express.static 中间件函数设置静态目录的顺序查找文件。

注意:为获得最佳效果,使用反向代理 缓存以提高服务静态资产的性能。

express.static 函数服务的文件创建虚拟路径前缀(该路径实际上并不存在于文件系统中),指定挂载路径 为静态目录,如下所示:

app.use('/static', express.static('public'))

现在,您可以从 /static 路径前缀加载 public 目录中的文件。

http://localhost:3000/static/images/kitten.jpg
http://localhost:3000/static/css/style.css
http://localhost:3000/static/js/app.js
http://localhost:3000/static/images/bg.png
http://localhost:3000/static/hello.html

但是,您提供给 express.static 函数的路径是相对于您启动 node 进程的目录的。如果您从另一个目录运行 express 应用程序,使用您要服务的目录的绝对路径会更安全:

const path = require('path')
app.use('/static', express.static(path.join(__dirname, 'public')))

有关 serve-static 功能及其选项的更多详细信息,请参阅 serve-static

Last Updated: 6/17/2023, 6:57:19 PM