我们一起来喜欢TypeScript
现在写js不用TypeScript,伦家可能会觉得你是外星人。
是的,TypeScript很大程度增强了代码的可读性,可跟踪性,可维护性和减少了bug。
那么没有理由不适用TypeScript进行js开发,但是回归本质,要根据实际出发,不是盲目的一来直接上TS。
我参与过一些使用TS开发的项目,也发现使用TS出现的问题。
举点例子:
- 无处不见的any
- 无视TS
高版本的express已经内置TS, 实际上到处还是any。
app.get("/", function(req: any, res: any) {
res.send("Hello," + data.name);
});
- 本身一个函数能写完的代码,却写一个class来完成
- tslint编译一堆错误,依旧无视
这条倒是其次, 因为很多时候,也许你没有那么多时间去处理这些问题。也说明我们在工程化下的功夫不足。
node和typescript
node + typescript 入门级别的配置真的特别简单。
- npm安装typescript
- 配置tsconfig.json
- 配置package.json的scripts命令
简单三步,你就可以通过简单的一步npm run xxx,TS文件们就乖乖的变为了js文件。
然后执行node dist/xx.js就能启动你的服务了。
但是,这不是我们所期望的。
我们希望我修改ts文件后,自动编译为js文件,然后启动服务。
我了解的相对较好的有下面三种方式:
ts-node-dev
这个方案是无意中看到的,star并不是特别多,400左右。
ts-node-dev 是基于 ts-node 的。
ts-node 可以直接执行ts文件,是不是很酷。
一句代码就可以监听文件变化,并运行编译后的代码。
~~~
ts-node-dev --respawn app.ts
~~~
我为什么要将Typescript与Express、nodejs一起使用(译文)
TypeScript-Node-Starter
微软这也有一个参考。也有对tslint的支持。
基本思路就是package.json 的scripts。
其主要使用的是 concurrently 和# nodemon。
其package.json的scripts如下:
"scripts": {
"start": "npm run serve",
"build": "npm run build-sass && npm run build-ts && npm run tslint && npm run copy-static-assets",
"serve": "node dist/server.js",
"watch-node": "nodemon dist/server.js",
"watch": "concurrently -k -p \"[{name}]\" -n \"Sass,TypeScript,Node\" -c \"yellow.bold,cyan.bold,green.bold\" \"npm run watch-sass\" \"npm run watch-ts\" \"npm run watch-node\"",
"test": "jest --forceExit --coverage --verbose",
"watch-test": "npm run test -- --watchAll",
"build-ts": "tsc",
"watch-ts": "tsc -w",
"build-sass": "node-sass src/public/css/main.scss dist/public/css/main.css",
"watch-sass": "node-sass -w src/public/css/main.scss dist/public/css/main.css",
"tslint": "tslint -c tslint.json -p tsconfig.json",
"copy-static-assets": "ts-node copyStaticAssets.ts",
"debug": "npm run build && npm run watch-debug",
"serve-debug": "nodemon --inspect dist/server.js",
"watch-debug": "concurrently -k -p \"[{name}]\" -n \"Sass,TypeScript,Node\" -c \"yellow.bold,cyan.bold,green.bold\" \"npm run watch-sass\" \"npm run watch-ts\" \"npm run serve-debug\""
}
TypeScript with Node.js里面提供了更加简单的方法。 nodemon + ts-node
~~~
"scripts": {
"start": "npm run build:live",
"build": "tsc -p .",
"build:live": "nodemon --watch 'src/**/*.ts' --exec 'ts-node' src/index.ts"
},
~~~
TypeScript-Node-Starter的package.json可以好好看看,具有很好的扩展性。
3. gulp-typescript + gulp-nodemon
gulp-typescript负责编译ts
gulp-nodemon负责启动服务
主要任务就是copy, compile和watch
const gulp = require("gulp");
const ts = require("gulp-typescript");
const nodemon = require('gulp-nodemon')
const del = require('del');
const sourcemaps = require('gulp-sourcemaps');
const tsProject = ts.createProject("tsconfig.json", { noImplicitAny: true });
// 默认任务
gulp.task("default", ["copy", "compile", "watch"], function () {
console.log('started .....')
})
// 复制配置文件
gulp.task('copy', function () {
return gulp.src("./src/config/**/*.json")
.pipe(gulp.dest("./dist/config"))
})
// 编译
gulp.task("compile", function () {
return gulp.src("./src/**/*.ts")
.pipe(sourcemaps.init({ loadMaps: true }))
.pipe(tsProject())
.js
.pipe(sourcemaps.write('./maps'))
.pipe(gulp.dest("dist"));
})
gulp.task('build',['compile','copy'])
// 删除
gulp.task('del', function (cb) {
return del([
'dist/**',
], cb);
});
// 监听变化
gulp.task('watch', ['compile'], function (done) {
var stream = nodemon({
script: 'dist/app.js',
watch: 'src/**',
tasks: ['copy', 'compile'],
done: done,
ext: 'ts html json'
})
return stream
})
使用typescript开发node js
TypeScript with Node.js
-------------------------
ESLint
到这里,我们已经又进了一步。
VSCode本身有插件TSLint插件,而且有新旧版。
ESLint插件默认是 可以读取tslint.json的配置的,如果没有,他有自己的默认配置。
新版的,如果有错误,默认是警告,而不是错误提示。
你去首选项勾选掉:tslint.alwaysShowRuleFailuresAsWarnings
即可。
我们是需要添加eslint.json配置的
- 方便自定义
- eslint编译检查,比如你的同事是用txt文件编写的呢。
因此,我们还需要安装tslint包。
还需要在package.json的文件里面添加一个脚本
"tslint": "tslint -c tslint.json -p tsconfig.json",
Prettier
代码美化。很多编辑器都有类似功能, VSCode也不例外。
VSCode的Prettier内置了prettier-eslint
和prettier-tslint
插件。
你可以在配置里面json文件修改或者配置面板修改。
"prettier.eslintIntegration": false,
这样一来,Prettier使用的就是tslint的配置。
在这里以后, windows换将下,默认情况,你就可以Ctl + Shift + F
自动格式化代码了。而且是按照你的tslint配置来格式化的, 就问你怕不怕。
总结
我们最后来看一下package.json下scripts的配置
"scripts": {
"build": "npm run tslint && npm run build-ts",
"build-ts": "tsc",
"watch-ts": "tsc -w",
"watch-node": "nodemon dist/app.js",
"tslint": "tslint -c tslint.json -p tsconfig.json",
"dev": "concurrently \\"npm:watch-ts\\" \\"npm run watch-node\\""
}
- build: 最终的构建
- build-ts: 仅仅是build TS文件
- watch-ts: 文件变化时,就build
- watch-node: build后的文件变化后,就重启服务
- tslint: TS语法检查
- dev: 开发模式下,修改ts文件后,自动build为js文件,并启动服务。
这样一来,感觉轻松多了。
想想就没好,自动美化代码,编写后自动启动服务。
喝点茶,出去走走。