Vue 脚手架（打包工具）的理解 - 配置文件理解

短命女 2024-03-16 09:20 33阅读 0赞

## 序言 ##

`Vue` 脚手架是 `Vue` 作为一个前端开发项目的最核心点，将`JavaScript`、`CSS`、`HTML`这几种前端自动整合，极大的简化了前端开发工作。

没有 Vue 脚手架，就没有 Vue ，这是一定的，Java 语言和C语言都需要编译，那么你可以将 Vue 脚手架看作是伪编译器吧，或者是伪解释器，当然伪解释器比较准确点。

## 个人理解 ##

在笔者看来，`Vue` 项目有时会出现两个问题，一个是旧版本的 `Vue` 脚手架，一个是新版本的`Vue` 脚手架，笔者不太清楚哪些 `Vue`脚手架版本是算是旧版，还是新版，但是很明确的知道，部分`Vue` 项目的的确确会出现一种情况，那就是没有 `public` 目录的情况，当遇到这种情况，的确会出现额外的问题需要解决，问题在于 `index.html` 文件的放置问题，比如新版 `Vue` 脚手架正常情况下，`index.html` 文件都会在 `Vue` 项目创建时，便已被放置在 `public` 目录下，但是旧版 `Vue` 脚手架，却会直接将 `index.html`文件放置在 `Vue` 项目的根目录下，在我看来，有些不规范，对于强迫症而言，的确有些不舒服。

笔者尝试修改旧版 Vue 脚手架 index.html 路径问题思路如下：

1.  修改 `process.env.BASE_URL`，但涉及源码比较深入，不宜操作，舍弃
2.  关于开发环境和生产环境下的自定义 index.html 路径问题，但是打包时容易出错，无法正常打包，这一点看问题1 的报错，有解决方法。（推荐）

下面是笔者在无 `public` 目录情况下，遇到的 `Vue` 项目开发问题集锦。

如下问题出现的前提：`Vue`项目创建后，没有 `public` 目录的情况：

## 问题 1 新建 public 目录，修改其打包路径问题 ##

（已解决，记录一下解决过程）

## 开发环境index.html文件路径配置 ##

新建了 `public` 目录，并将 `index.html` 目录，移动到 `public` 目录内，并修改 `webpack.dev.conf.js` （开发环境配置文件）文件内的 `HtmlWebpackPlugin` 配置，如下所示

![在这里插入图片描述][1d7f3b5086a04137ad15170d8d71af14.png]

new HtmlWebpackPlugin({
        
          filename: 'index.html',
          template: './public/index.html',
          inject: true
        }),

成功在本地开发环境运行成功（`cnpm run dev`），并显示在本地浏览器上，在`webpack.prod.conf.js` 文件（生产环境配置文件）内设置了一样的配置。

当然笔者不保证是一样的配置路径，笔者这里的是相对路径配置，所以如果你打包时，会出现如下报错，那么仔细研究下，路径问题，到底是`'./public/index.html'`还是 `'../public/index.html'`

报错：

![在这里插入图片描述][b212450f3418439194ed5fcfe82fbe32.png]

ERROR in   Error: Child compilation failed:
      Entry module not found: Error: Can't resolve 'E:\VueProject\public\index.html' in 'E:\VueProject\testproject':
      Error: Can't resolve 'E:\VueProject\public\index.html' in 'E:\VueProject\testpriject'

--------------------

## 问题2 favicon 图标的放置问题 ##

如果有 public 目录，那么正常情况下，我们都能将 favicon 图标放置在 public 目录下，当然这一点在 index.html 文件内需要我们配置好 favicon 的路径，如下：

但是很遗憾，我们无法如此，会遇到报错 `Vue Template execution failed: ReferenceError: BASE_URL is not defined`

当然，我们也不用这么麻烦，只需要将 favicon.ico 的图标文件，放到 static 文件就行了，打包的时候，就不会出错了，当然，这里笔者的 index.html 配置如下所示：

不是所谓的

当然，如果实在是强迫症的，想要将其图标文件放到 public 目录下，可以研究下 `CopyWebpackPlugin` 插件

![在这里插入图片描述][0c30a6d21a0141c8887e3fb9e06e0d94.png]  
该插件的作用在于，收集静态文件到指定的打包路径位置，所以应该可以打包 public 目录下的静态文件。如下解决问题2 参考链接4 02-02模块化作业

![在这里插入图片描述][f53343fd230a46dfb4df2f2c60c72043.png]

当然，上面只是启发，具体的实现是在 `webpack.prod.conf.js` 文件（生产环境配置文件），开发环境的配置也是如此（`webpack.dev.conf.js`）

#### 1、生产环境打包配置 `webpack.prod.conf.js` ： ####

（注意看是 `config.build.assetsSubDirectory`）

// copy custom static assets
        new CopyWebpackPlugin([
          {
        
            from: path.resolve(__dirname, '../static'),
            to: config.build.assetsSubDirectory,
            ignore: ['.*']
          },
          {
        
            from: path.resolve(__dirname, '../public'),
            to: config.build.assetsSubDirectory,
            ignore: ['.*']
          }
        ])

笔者发现了一点不好的是，如果将 index.html 和 favicon.ico 文件放到 public 目录内，那么打包时，也会顺便把 index.html 复制两份，一份是在 Vue 打包的 dist 根目录下的，一份是在 static 目录内，有些冗余不规范且麻烦，要手动删除。  
![在这里插入图片描述][734f8ceaa951474295cb8e1a1bf5d0a8.png]

所以这里还需要配置一个忽略 `index.html` 的设置。如下：

#### 2、开发环境 `webpack.dev.conf.js` 配置： ####

（注意看是 `config.dev.assetsSubDirectory`）

// copy custom static assets
        new CopyWebpackPlugin([
          {
        
            from: path.resolve(__dirname, '../static'),
            to: config.dev.assetsSubDirectory,
            ignore: ['.*']
          },
          {
        
            from: path.resolve(__dirname, '../public'),
            to: config.dev.assetsSubDirectory,
            ignore: ['index.html']
          }
        ])

关于自动清除上一次打包遗留的文件，我觉得不需要去专门安装 `CleanWebpackPlugin`，打包时（`cnpm run build` 、`cnpm run build:prod`），`Vue` 脚手架会自动删除上一次的打包文件，所以完全没必要。

`assetsPublicPath` 按默认的就好，默认是 `'/'`

这里的 assetsPublicPath 配置关于 public 目录完全没有关联的，关联的是 URL前端的公共路径，所以有点误导人。

![在这里插入图片描述][f79e4a5cbfff40bda0f3c80d5a5635d6.png]

### 解决问题2 参考链接 ###

[1. Vue Template execution failed: ReferenceError: BASE\_URL is not defined][1. Vue Template execution failed_ ReferenceError_ BASE_URL is not defined]

[2. Template execution failed ReferenceError BASE\_URL is not defined][2. Template execution failed ReferenceError BASE_URL is not defined]

[3. Template execution failed: ReferenceError: BASE\_URL is not defined][3. Template execution failed_ ReferenceError_ BASE_URL is not defined]

[4. 02-02模块化作业][4. 02-02]

[5. webpack入门（六）——html-webpack-plugin][5. webpack_html-webpack-plugin]

[6. vuecli3.0 htmlWebpackPlugin 报 ReferenceError: BASE\_URL is not defined 错误][6. vuecli3.0 htmlWebpackPlugin _ ReferenceError_ BASE_URL is not defined]

[7. vue-cli脚手架项目中public和src/assets的区别][7. vue-cli_public_src_assets]

[8. Vue CLI 3 public 目录没用吗 ][8. Vue CLI 3 public _]

[9. vue@cli3项目模板怎么使用public目录下的静态文件][9. vue_cli3_public]

[10. vue项目中的public、static及指定不编译文件问题怎么解决][10. vue_public_static]

[11. 我创建的项目里没有public文件][11. _public]

[12. vue项目打包需要修改的路径问题][12. vue]

[13. vue项目中引用public下面的文件][13. vue_public]

[14. vue-cli2、vue-cli3脚手架详细讲解][14. vue-cli2_vue-cli3]

## 对本问题2 无效的参考链接 ##

[1. vue项目设置浏览器icon图标][1. vue_icon]

[2. vue中添加favicon 图标 （3种方法）][2. vue_favicon _ _3]

[3. 大白话Vue之publicPath][3. _Vue_publicPath]

[4. vue项目中配置favicon图标][4. vue_favicon]

[5. vue项目添加favicon的几种方式][5. vue_favicon]

[1d7f3b5086a04137ad15170d8d71af14.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/efe681297a714886b2e29512e06ad3bf.png
[b212450f3418439194ed5fcfe82fbe32.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/fe77a9fe788e495ab314446a42d43dc0.png
[0c30a6d21a0141c8887e3fb9e06e0d94.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/fb8e0e7dc25141d78f66fb3f88bb6c7a.png
[f53343fd230a46dfb4df2f2c60c72043.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/37a7f5fefde142d98f79fa604fcd1a3d.png
[734f8ceaa951474295cb8e1a1bf5d0a8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/097cfb22cf844fb194d2fb14ba6afe63.png
[f79e4a5cbfff40bda0f3c80d5a5635d6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/fc776b468d68451d88f4238fac7477b3.png
[1. Vue Template execution failed_ ReferenceError_ BASE_URL is not defined]: https://blog.csdn.net/ForeverBana/article/details/105934659
[2. Template execution failed ReferenceError BASE_URL is not defined]: https://segmentfault.com/a/1190000022548212?sort=newest
[3. Template execution failed_ ReferenceError_ BASE_URL is not defined]: http://blog.superabbit.cn/article/detail/4a2cb9968e8d40099b56d757c46f9c2a
[4. 02-02]: https://blog.csdn.net/weixin_37711211/article/details/112451277
[5. webpack_html-webpack-plugin]: https://blog.csdn.net/itKingOne/article/details/70225584
[6. vuecli3.0 htmlWebpackPlugin _ ReferenceError_ BASE_URL is not defined]: https://www.cnblogs.com/ctb-web/p/11944467.html
[7. vue-cli_public_src_assets]: https://blog.csdn.net/Amnesiac666/article/details/111478209?utm_medium=distribute.pc_relevant.none-task-blog-2~default~baidujs_baidulandingword~default-4-111478209-blog-85072120.235%5Ev36%5Epc_relevant_default_base3&spm=1001.2101.3001.4242.3&utm_relevant_index=7
[8. Vue CLI 3 public _]: https://blog.csdn.net/w993263495/article/details/85072120
[9. vue_cli3_public]: https://www.mianshigee.com/note/detail/25031jey/
[10. vue_public_static]: https://www.mdaima.com/it/4797.html
[11. _public]: https://ask.csdn.net/questions/7674451
[12. vue]: https://blog.csdn.net/devincob/article/details/104755816/
[13. vue_public]: https://www.cnblogs.com/chenwan1218/p/13644084.html
[14. vue-cli2_vue-cli3]: https://www.cnblogs.com/hgdzjp/p/11756689.html
[1. vue_icon]: https://blog.csdn.net/weixin_48398799/article/details/116496792?spm=1001.2101.3001.6650.7&utm_medium=distribute.pc_relevant.none-task-blog-2~default~BlogCommendFromBaidu~Rate-7-116496792-blog-81699376.235%5Ev36%5Epc_relevant_default_base3&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2~default~BlogCommendFromBaidu~Rate-7-116496792-blog-81699376.235%5Ev36%5Epc_relevant_default_base3&utm_relevant_index=8
[2. vue_favicon _ _3]: https://blog.csdn.net/qq_41646249/article/details/84249031?spm=1001.2101.3001.6650.1&utm_medium=distribute.pc_relevant.none-task-blog-2~default~CTRLIST~Rate-1-84249031-blog-81699376.235%5Ev36%5Epc_relevant_default_base3&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2~default~CTRLIST~Rate-1-84249031-blog-81699376.235%5Ev36%5Epc_relevant_default_base3&utm_relevant_index=2
[3. _Vue_publicPath]: https://blog.csdn.net/baidu_35007727/article/details/125024156
[4. vue_favicon]: https://blog.csdn.net/XuM222222/article/details/81699376?spm=1001.2101.3001.6650.1&utm_medium=distribute.pc_relevant.none-task-blog-2~default~CTRLIST~Rate-1-81699376-blog-84249031.235%5Ev36%5Epc_relevant_default_base3&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2~default~CTRLIST~Rate-1-81699376-blog-84249031.235%5Ev36%5Epc_relevant_default_base3&utm_relevant_index=2
[5. vue_favicon]: https://blog.csdn.net/z591102/article/details/115518272