Webpack 5 字体资源打包与CSS路径优化
使用Webpack 5打包项目时，有效管理静态资源（如字体文件）的路径至关重要。本文将详细讲解如何将所有字体资源打包到指定目录，并自动更新CSS中字体文件的引用路径。
问题： 项目使用Webpack 5打包样式资源，字体文件和CSS文件初始位于同一目录。目标是将字体文件打包到custom_fonts/子目录，CSS文件保留在主目录，并自动更新CSS中字体文件的路径，使其指向custom_fonts/目录下的字体文件。 直接使用file-loader移动字体文件后，发现字体文件在主目录和custom_fonts/目录中都存在，且CSS仍然引用主目录下的字体文件。
初始Webpack配置：
立即学习“前端免费学习笔记（深入）”；
const path = require('path');
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
module.exports = {
mode: 'production',
entry: './index.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'index.js'
},
resolve: {
extensions: ['.ts', '.js', '.scss', '.css']
},
module: {
rules: [
{
test: /\.js$/,
exclude: /node-modules/
},
{
test: /\.(woff|woff2|eot|ttf|otf)$/,
use: [
{
loader: 'file-loader',
options: {
name: '[hash].[ext]',
outputPath: 'fonts/', // 输出路径
}
}
]
},
{
test: /\.scss$/,
use: [
MiniCssExtractPlugin.loader,
{ loader: 'css-loader', options: { importLoaders: 2 } },
'resolve-url-loader', // 关键：确保此loader在sass-loader之前
{
loader: 'sass-loader',
options: { sourceMap: true }
}
]
}
]
},
plugins: [
new MiniCssExtractPlugin({
filename: 'styles.css', // 输出的CSS文件名
}),
]
};
解决方案： 关键在于resolve-url-loader。file-loader负责将字体文件移动到指定目录，resolve-url-loader则解析CSS中的URL，并根据file-loader生成的路径进行更新。 确保resolve-url-loader在sass-loader之前使用，才能正确处理Sass文件中的URL。
将字体文件移动到custom_fonts/目录，只需修改file-loader的outputPath选项：
options: {
name: '[hash].[ext]',
outputPath: 'custom_fonts/', // 修改输出路径
}
修改后的配置将字体文件打包到custom_fonts/目录，resolve-url-loader会自动更新CSS文件中的字体引用路径，实现字体文件集中管理和CSS正确引用。
