从零开始,一步一步搭建Typescript+React+Redux项目——开发环境配置和启动React(二)

本文详细介绍了如何从零开始搭建一个 Typescript + React 开发的脚手架,包含如何添加 Redux 以及 React Router 的环境。

本文代码地址:ts-react-redux

建议将代码拉下来之后,配合本文一起查看,效果更佳。

代码下载命令:git clone https://github.com/vettel-qin/ts-react-redux.git

相关文章目录

从零开始,一步一步搭建Typescript + React + Redux项目——创建项目结构(一)

从零开始,一步一步搭建Typescript + React + Redux项目——开发环境配置(二)

从零开始,一步一步搭建 Typescript + React + Redux项目——集成React(三)

从零开始,一步一步搭建 Typescript + React + Redux项目——集成Redux(四)

从零开始,一步一步搭建 Typescript + React + Redux项目——项目打包(五)

从零开始,一步一步搭建 Typescript + React + Redux项目——团队合作规范(六)

一、webpack 配置

1、安装webpack相关插件

(1)、为了用Typescript书写 webpack 的配置文件,必须先安装相关依赖:

yarn add add typescript@3.8.3 ts-node@8.8.2 @types/node@13.9.1 -D

(2)、webpack原本的包不包含验证包,所以需要安装相关ts验证包

yarn add webpack@4.42.1 @types/webpack@4.41.10 webpack-cli@3.3.10 -D

2、入口和出口

(1)、在tools目录下新建paths.config.ts??

(2)、在tools目录下新建webpack.config.ts 增加如下代码:??

3、配置html-webpack-plugin

首先安装yarn add html-webpack-plugin@3.2.0 @types/html-webpack-plugin@3.2.0 -D,然后在webpack的plugins配置项下进行简单配置:??

4、设置模式

webpack 配置中的 mode 属性,可以设置为 'development' 和 'production',然后在webpack.config.ts中添加如下配置:??

5、设置devtool

为了方便在项目出错时,迅速定位到错误位置,可以设置 devtool,生成资源映射,我们这里使用

inline-source-map,更多选择可以在这里查看区别。然后在webpack.config.ts中添加如下配置:??

?6、使用 webpack-dev-server 启动项目服务

安装 yarn add webpack-dev-server@3.10.3 @types/webpack-dev-server@3.10.1 -D,然后在webpack的devServer配置项下进行简单配置??

?7、在package.json文件中添加一个执行脚本,用来执行webpack命令:??

?8、运行项目,测试配置是否成功

执行 yarn start 命令,命令行提示成功后,在浏览器器打开http://localhost:8080,可以看到??

二、安装 react 相关

react原本的包不包含验证包,所以需要安装相关ts验证包

yarn add react@16.13.1 react-dom@16.13.1 -S

yarn add @types/react@16.9.34 @types/react-dom@16.9.6 -D

配置tsconfig.json

三、配置 ts\tsx 相关 babel

1、使用babel-loader

安装yarn add @babel/core@7.9.0 babel-loader@8.1.0 -D,然后在webpack的module配置项下进行配置??

?2、使用babel相关presets

@babel/preset-env,可以在项目中使用所有ECMAScript标准里的最新特性。

@babel/preset-react,可以在项目中使用 react 语法。

安装yarn add @babel/preset-env@7.9.5 @babel/preset-react@7.9.4 -D,然后在webpack的module配置项下添加如下配置:??

?3、使用 babel 相关 plugins

@babel/plugin-syntax-dynamic-import,可以在项目中使用import()这种语法

安装 yarn add @babel/plugin-syntax-dynamic-import@7.8.3 -D,然后在webpack的module配置项下添加如下配置:??

?4、安装ts-loader

这款loader用于将ts代码编译成js代码

yarn add ts-loader@7.0.0 -D,然后在webpack的module配置项下添加如下配置:??

?5、使用cache-loader

在一些性能开销较大的loader之前添加此loader,以将结果缓存到磁盘里。

安装 yarn add cache-loader -D,然后在webpack的module配置项下babel-loader之前添加配置:??

6.启动react测试

(1)、修改src/entries/index.ts文件为index.tsx

(2)、修改webpack.config.ts入口

(3)、运行项目,测试配置是否成功

??四、配置 CSS 相关 loader

1、支持sass

安装yarn add style-loader@1.1.4 css-loader@3.5.2 node-sass@4.13.1 sass-loader@8.0.2 -D

配置webpack,在module.rules下面对.scss和.css文件类型的编译配置??

2、自动添加浏览器前缀

(1)、安装yarn add postcss-loader@3.0.0 autoprefixer@9.7.6 -D,然后在webpack.config.js的module.rules配置postcss-loader??, 并修改css-loader前应用的loader数量为2

(2)、在package.json里面配置定义需要支持的浏览器范围

?3、配置公共scss

(1)、新建公共样式目录

在src目录下新建styles文件夹,然后在styles文件夹新建variables.scss文件用于存放样式变量??

?(2)、引用公共scss

a、在tools文件夹中的paths.config.ts添加??

?b、使用node-sass的属性includePaths进行优化??

?c、效果(不管文件层级有多深都可以直接引入)???

?五、配置图片、文件相关loader

安装 yarn add url-loader file-loader -D,然后在webpack.config.js的module.rules配置url-loader、file-loader??

1、图片篇

(1)、在src目录下新建assets目录存放图片,并在index.tsx引用

注:出现“找不到??椤蔽侍?,

这个问题是因为图片文件中没有类似export这样的关键词用于导出一个???,所以导致找不到???,可以通过ts的类型定义文件中的模块声明(declare module)来解决。

解决方案:

在根目录下新建一个typings文件夹,用于存在放图片等模块声明, 以及后续需要用到的全局校验接口,在typings文件夹新建import.d.ts文件

(2)、在src/entries新建样式文件为index.scss并在index.tsx引用

2、字体篇

3、音频篇

??六、优化路径

1、第一种方案在webpack.resolve.alias中进行路径配置??(推荐)

?同时需要在tsconfig.json中进行配置??

?2、第二种方案, 用tsconfig-paths-webpack-plugin这个包将tsconfig中对路径的设置映射到webpack配置中去,这样就不需要在webpack中再进行一次路径的配置了,首先安装:yarn add tsconfig-paths-webpack-plugin@3.2.0 -D,然后采用第一种方案的tsconfig配置,接着配置webpack,引入tsconfig-paths-webpack-plugin??

七、启动热加载

1、在devServer配置项下添加hot: true和hotOnly: true

2、在webpack的plugins配置项下添加new webpack.HotModuleReplacementPlugin()和new?webpack.NamedModulesPlugin()

3、安装yarn add?react-hot-loader@4.12.20 -D,在webpack.config.ts的entry中加入react-hot-loader/patch,且一定要写在entry的最前面,如果有babel-polyfill就写在babel-polyfill后面。在babel-loader中添加plugin

4、最后,需要在页面的主入口中添加相关代码

(1)、在src/components目录下新建App.tsx和App.css

App.tsx??

App.css为reset.css,可参考https://www.css-reset.com/

(2)、修改src/entries/index.ts文件为index.tsx并引用App组件

注:出现'类型“NodeModule”上不存在属性“hot”'问题,解决办法:

a.if(moduleasany).hot{}

b. yarn add @types/webpack-env -D

??(3)、运行项目,测试配置是否成功

文章及代码中如有问题,欢迎指正,谢谢!

最后编辑于
?著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,128评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,316评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事?!?“怎么了?”我有些...
    开封第一讲书人阅读 159,737评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,283评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,384评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,458评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,467评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,251评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,688评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,818评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,492评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2 352