Webpack5 搭建 Vue3 + TS 项目,web网页开发

为何升级?除了折腾外,便是享受新版本带给我们的新特性体验。

Webpack5 的新特性

  • 持久化缓存

  • moduleIds & chunkIds 的优化

  • 更智能的 tree shaking

  • Module Federation

Vue3 的新特性

  • 更小

  • 更快

  • 加强 TypeScript 支持

  • 加强 API 设计一致性

  • 提高自身可维护性

  • 开放更多底层功能

确定项目技术栈

  • 编程语言:TypeScript 4.2.4

  • 构建工具:[Webpack 5.33.2]()

  • 前端框架:Vue 3.0.11

  • 路由工具:Vue Router 4.0.6

  • 状态管理:Vuex 4.0.0

  • CSS 预编译:Sass / Less

  • HTTP 工具:Axios

  • Git Hook 工具:Husky + Lint-staged

  • 代码规范:EditorConfig + Prettier + ESLint

  • 提交规范:Commitlint

  • 构建部署:Travis

3. 项目搭建


此文并不是从零搭建,而是在 createVue@v1.0.0 的基础上修改搭建,如若看不懂,可以先看《Webpack4 搭建 Vue 项目》,跟着一步步搭建,后再看此文升级

创建 createVue 文件夹,进入该文件夹, npm init 初始化项目

老规矩,安装 webpack 四件套npm i webpack webpack-cli webpack-dev-server webpack-merge --save-dev

当前使用版本:

“webpack”: “^5.33.2”,

“webpack-bundle-analyzer”: “^4.4.1”,

“webpack-cli”: “^4.6.0”,

“webpack-dev-server”: “^3.11.2”,

“webpack-merge”: “^5.7.3”,

webpack5 启动开发服务器命令与之前有所变化,从 webpack-dev-server 转变为 webpack serve, 因此 package.json 中 script 的 start 修改为: "start": "webpack serve --progress --hot --inline --config build/webpack.dev.js"

  1. 创建相应文件

与之前没有太大差异。增加变动的有一下几点:

1). 持久化缓存,增加 cache 配置. v5 中缓存默认是 memory,修改设置"filesystem"写入硬盘

// webpack.dev.js

module.exports = merge(common, {

cache: {

type: ‘filesystem’,

}

//…

}

2). 去除插件 clean-webpack-plugin(v5支持),webpack.HashedModuleIdsPlugin(v5更好的 moduleIds & chunkIds),HardSourceWebpackPlugin(v5支持),happypack(v5不兼容)

安装 vue 核心解析插件

解析插件有所不同,从 vue-template-compiler 变成了 @vue/compiler-sfcvue-loader 保持不变。 npm i vue-loader @vue/compiler-sfc --save-dev

// 当前我使用版本

“vue-loader”: “^16.2.0”,

“@vue/compiler-sfc”: “^3.0.11”,

安装 vue3 及相关库,添加 vue 类型文件

npm i vue@next vuex@4.0.0-rc.1 vue-router --save

src 文件夹下添加 shims-vue.d.ts 文件,解决 vue 类型报错

// shims-vue.d.ts

declare module ‘*.vue’ {

import type { DefineComponent } from ‘vue’

const component: DefineComponent<{}, {}, any>

export default component

}

安装 html 模板解析插件

npm i html-webpack-plugin --save-dev

安装 typescript 及解析插件

npm i typescript ts-loader --save-dev

配置ts-loader解析:

// webpack.base.js

// rules

{

test: /.(t|j)s$/,

exclude: /node_modules/,

use: [

{

loader: ‘ts-loader’,

options: {

// 指定特定的ts编译配置,为了区分脚本的ts配置

configFile: path.resolve(__dirname, ‘…/tsconfig.loader.json’),

// 对应文件添加个.ts或.tsx后缀

appendTsSuffixTo: [/.vue$/],

},

},

],

}

ts-loader 为单进程执行类型检查和转译,因此效率有些慢,可以用多进程方案:即关闭ts-loader的类型检查,类型检查由 fork-ts-checker-webpack-plugin 插件执行。npm i fork-ts-checker-webpack-plugin --save-dev

// webpack.base.js

// rules

{

test: /.(t|j)s$/,

exclude: /node_modules/,

use: [

{

loader: ‘ts-loader’,

options: {

// 指定特定的ts编译配置,为了区分脚本的ts配置

configFile: path.resolve(__dirname, ‘…/tsconfig.loader.json’),

// 对应文件添加个.ts或.tsx后缀

appendTsSuffixTo: [/.vue$/],

transpileOnly: true, // ? 关闭类型检查,即只进行转译

},

},

],

}

// plugins push

new ForkTsCheckerWebpackPlugin()

至此项目基本可以跑起来了,那么有个问题了:Ts 可以编译为指定版本的 js,那么还需要 babel 么?

tsc 的 target 只转译语法,不集成 polyfill,所以还是得要 babel。

比如把箭头函数转成普通 function、aysnc + await 变成 Promise.then,这是语法转译;

但你运行环境里如果没有 Promise.prototype.finally,那没有就还是没有。

因此我们项目里还是需要 babel.

Webpack 转译 Typescript 现有方案:

综合考虑性能和扩展性,目前比较推荐的是 babel+fork-ts-checker-webpack-plugin 方案。

在 babel7 之前,是需要同时使用 ts-loader 和 babel-loader 的,其编译过程 TS > TS 编译器 > JS > Babel > JS 。可见编译了两次js,效率有些低下。但是 babel7 出来之后有了解析 typescript 的能力,有了这一层面的支持,我们就可以只使用 babel,而不用再加一轮 ts 的编译流程了。

在 babel 7 中,我们使用新的 @babel/preset-typescript 预设,结合一些插件便可以解析大部分的 ts 语法。

那么,Babel 是如何处理 TypeScript 代码的呢?

Babel 删除了所有 TypeScript,将其转换为常规的 JavaScript,并继续以它自己的方式处理。删除了 typescript 则不需要进行类型检查,不会有烦人的类型错误提醒,因此编译速度提升,开开心心编程???

当然,类型安全性检查必不可少,我们可以统一在某个时间集中处理,增加 script:

“check-types”: “tsc --watch”,

添加 babel 解析 typescript

# 安装以下依赖 --save-dev

# webpack loader

babel-loader

# babel 核心

@babel/core

# 智能转换成目标运行环境代码

@babel/preset-env

# 解析 typescript 的 babel 预设

@babel/preset-typescript

# polyfill

@babel/plugin-transform-runtime

# 支持 ts 类的写法

@babel/plugin-proposal-class-properties

# 支持三点展开符

@babel/plugin-proposal-object-rest-spread

# 安装以下依赖 --save

@babel/runtime

@babel/runtime-corejs3

“core-js”: “^3.11.0”,

删除 ts-loader, 添加 babel-loader

{

test: /.(t|j)s$/,

exclude: /node_modules/,

use: [

{

loader: ‘babel-loader’,

},

],

}

项目根目录添加 babel 配置文件 babel.config.js

module.exports = {

presets: [

[

‘@babel/preset-env’,

{

useBuiltIns: ‘usage’, // 按需引入 polyfill

corejs: 3,

},

],

[

‘@babel/preset-typescript’, // 引用Typescript插件

{

allExtensions: true, // 支持所有文件扩展名,否则在vue文件中使用ts会报错

},

],

],

plugins: [

[

‘@babel/plugin-transform-runtime’,

{

corejs: 3,

},

],

‘@babel/proposal-class-properties’,

‘@babel/proposal-object-rest-spread’,

],

}

4. 代码规范


项目中代码规范集成了 EditorConfig, Prettier, ESLint, Husky, Lint-staged,以及如何解决 Prettier 和 ESLint 的冲突的问题,具体实现可以参考 《从 0 开始手把手带你搭建一套规范的 Vue3.x 项目工程环境》这篇文章,讲的很详细这里不再赘述。

5. 提交规范


利用 inquirer 选择配置好的提交类型,以及配合 commitlint 实现 commit 检查

npm i inquirer shelljs @commitlint/{cli,config-conventional} -D

添加 package.json 的 script :

“commitlint”: “commitlint -e”,

“commit”: “node commit/git-commit.js”

创建 commit/git-commit.js 文件

const shell = require(‘shelljs’)

const inquirer = require(‘inquirer’)

const prompsConfig = {

ciType: [

{

type: ‘list’,

name: ‘type’,

message: ‘请选择本次提交的类型:’,

choices: [

{

name: ‘引入新特性’,

value: ‘feat’,

},

{

name: ‘改进代码的结构格式/样式’,

value: ‘style’,

},

{

name: ‘修复 bug’,

value: ‘fix’,

},

{

name: ‘提升性能’,

value: ‘perf’,

},

{

name: ‘删除代码或文件’,

value: ‘delete’,

},

{

name: ‘其他修改, 比如改变构建流程、或者增加依赖库、工具等’,

value: ‘chore’,

},

{

name: ‘重构’,

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

img

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!

如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)

最后的最后

面试题千万不要死记,一定要自己理解,用自己的方式表达出来,在这里预祝各位成功拿下自己心仪的offer。
需要完整面试题的朋友可以点击蓝色字体免费获取

大厂面试题

面试题目录

自学提升又不知道该从何学起的朋友,同时减轻大家的负担。**

[外链图片转存中…(img-7NirTWxN-1712234559064)]

[外链图片转存中…(img-qBiQqOHt-1712234559064)]

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!

[外链图片转存中…(img-cAFzHKxL-1712234559065)]

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!

如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)

最后的最后

面试题千万不要死记,一定要自己理解,用自己的方式表达出来,在这里预祝各位成功拿下自己心仪的offer。
需要完整面试题的朋友可以点击蓝色字体免费获取

[外链图片转存中…(img-S59M6C01-1712234559065)]

[外链图片转存中…(img-onaVxKZ5-1712234559065)]

[外链图片转存中…(img-5TdM8kuB-1712234559066)]

[外链图片转存中…(img-L6O0Kgc3-1712234559066)]

  • 11
    点赞
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
为了在Vue 3项目中使用TypeScript和Webpack,并且正确地生成.d.ts声明文件,你需要按照以下步骤进行配置: 1. 安装依赖: ```bash npm install --save-dev typescript ts-loader vue-loader@next @types/vue @vue/compiler-sfc ``` 2. 创建`tsconfig.json`文件: 在项目根目录下创建一个名为`tsconfig.json`的文件,并添加以下内容: ```json { "compilerOptions": { "target": "esnext", "module": "esnext", "strict": true, "jsx": "preserve", "moduleResolution": "node", "resolveJsonModule": true, "esModuleInterop": true, "lib": ["esnext", "dom"], "skipLibCheck": true, "forceConsistentCasingInFileNames": true }, "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue", "tests/**/*.ts", "tests/**/*.tsx"] } ``` 3. 配置Webpack: 在Webpack配置文件中,添加对TypeScript和Vue文件的处理规则。例如,如果你使用的是`webpack.config.js`文件,可以按照以下示例进行配置: ```javascript const path = require('path'); module.exports = { // ...其他配置 resolve: { extensions: ['.js', '.ts', '.vue'], alias: { '@': path.resolve(__dirname, 'src') } }, module: { rules: [ { test: /\.tsx?$/, loader: 'ts-loader', exclude: /node_modules/, options: { appendTsSuffixTo: [/\.vue$/] } }, { test: /\.vue$/, loader: 'vue-loader' } ] }, // ...其他配置 }; ``` 4. 添加Vue文件声明: 在项目的`src`目录中,为Vue文件添加一个`.d.ts`的同名文件。例如,对于`HelloWorld.vue`组件,创建一个名为`HelloWorld.vue.d.ts`的文件,并添加以下内容: ```typescript declare module '*.vue' { import { ComponentOptions } from 'vue'; const componentOptions: ComponentOptions; export default componentOptions; } ``` 5. 构建项目: 运行Webpack构建命令,以启动TypeScript编译和生成声明文件: ```bash npm run build ``` 如果一切顺利,你的Vue 3 + TypeScript项目应该可以成功编译,并且在构建过程中会生成相应的.d.ts声明文件。 希望以上步骤可以帮助你配置Vue 3 + TypeScript + Webpack项目的.d.ts声明文件。如果有任何问题,请随时追问!

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值