单页应用(SPA)在前端开发中越来越流行。Webpack 是构建 SPA 的一种流行工具，它能够自动化地将代码打包成静态文件。虽然 Webpack 能够优化代码，但在本地调试时，经常会出现打包后的页面本地运行黑屏或者空白的问题。本文将会介绍为什么会出现这个问题，以及如何解决。
什么是 SPA
SPA 是指单页应用程序(Single Page Application)，常常被应用于科技行业中的 Web 开发。与传统多页式应用程序相比，SPA 是通过 AJAX 请求更新页面中的局部内容，而不刷新整个页面。这种方式能够加快页面的打开速度，增强了用户体验。同时，由于减少了整个页面的刷新，具有更好的性能表现。
Webpack 打包的原理
Webpack 是基于模块的打包工具。它能够把应用程序的所有依赖关系，封装成一个或多个 JavaScript 模块，并生成一个或多个打包文件。因为 Webpack 将整个代码进行优化，所以打包后的代码相较直接运行的代码变得更小，加载更快，同时更符合浏览器的表现，因为代码文件已经经过了代码分离、tree shaking 以及代码压缩等一系列处理。
SPA 打包后本地运行空白
SPA 打包后在本地运行空白是一个比较常见的问题。这是由于 Webpack 的打包机制不支持本地打开，因为在打包完成后的源代码中始终存在包含在 bundle.js 中的 JavaScript 代码。一旦我们将打包好的 HTML，CSS 和 JS 文件放在本地服务器上时，就会发现页面出现了空白的情况。这就是因为浏览器看到我们服务器上的 HTML 页面并请求下载相关的 CSS 和 JS 文件，但这些文件都指向了一个本地的绝对路径，而并没有进行相应更改。
解决方法
现在我们来看看如何解决这个问题。解决方法其实有很多种，下面我们会介绍其中的两种方式。
1. 使用 Webpack 插件解决
Webpack 提供了一个名为html-webpack-plugin的插件。此插件可以帮助我们在打包过程中，将最终的 HTML 模板和打包后的 JS 文件都放到服务器上的某一个指定的路径下。具体来说，我们只需要在webpack.config.js里面配置以下代码：
----- ----------------- - -------------------------------
-- --- ----------------- ------------- ------ -- ------- -----
-------- -
--- -------------------
--------- ------------- -- --- ---- ---- ---- ---
--------- ----------------------- ------------------ -- ---- ---- ---
----- ----- -- ------------
---
-上面的代码通过 HtmlWebpackPlugin 将指定的 HTML 模板和打包后的 JS 文件都输出到 disk 目录下的 index.html 文件中。
2. 使用 Webpack Dev Server 解决
另一个解决方法是使用 Webpack Dev Server。Webpack Dev Server 是 Webpack 内置的开发服务器。让 Webpack 打包后的文件可以在本地服务器上运行。因此，它对打包后的文件进行实时编译，并在浏览器中实时更新网页，同时也解决了这个本地空白问题。这个解决方法非常简单，只需要在webpack.config.js中加入以下代码就行了：
---------------- - - ------------ -------------------- --------- ----- ----- -------- ---- -
这行代码告诉 Webpack，将文件输出到本地服务器的 dist 文件夹路径下，使用 port 3000 的端口来打开本地服务器。同时，hotOnly 选项可以防止整个页面刷新，只更新修改的部分。
结论
本文介绍了 Webpack 因为打包机制不支持本地打开而导致的本地空白问题，并提出了两种常用的解决方法。第一个方法是使用 HtmlWebpackPlugin 插件将最终的 HTML 模板和打包后的 JS 文件都输出到 disk 目录下的指定文件中。第二个方法是使用 Webpack Dev Server 使用本地服务器运行打包后的代码并实时更新浏览器中的内容。使用这两种方法，我们只需要一条命令就可以快速解决问题，同时也可以帮助我们更好地理解 SPA。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/66f70f11c5c563ced58e72f5