【AICon】探索RAG 技术在实际应用中遇到的挑战及应对策略!AICon精华内容已上线73%>>> 了解详情
写点什么

我踩过了 TypeScript 的坑,只想告诉你快来

  • 2022-07-20
  • 本文字数:3818 字

    阅读完需:约 13 分钟

我踩过了 TypeScript 的坑,只想告诉你快来

嘉宾 | 许侃

编辑 | 贾亚宁


用过 TypeScript 的开发者往往都会不约而同地直呼“真香”,但是我们也无法忽略 TypeScript 诸如学习曲线较陡和开发成本较高等阻碍。因此如何高效地使用和掌握 TypeScript,使其在中大型的项目中发挥最好的作用一直是大家讨论的热点话题。


本次我们邀请了 FreeWheel 的 Tech Lead 许侃老师,请他来分享对于 TypeScript 的应用和思考,同时许侃也是已经上线的 QCon+ 案例研习社「TypeScript 在中大型项目中的落地实践」专题的出品人,带队来分享 TypeScript 的最佳实践。

TypeScript 适用场景


许侃:从我们组的切换体验来看,TypeScript 主要是在大规模协作中保证了代码质量,很多错误可以在本地开发环境中被及时发现。因此对于 TypeScript 的适用场景,我个人觉得:对于 3 人以上的团队如果有一个公共项目需要协作开发,那么选择 TypeScript 利大于弊,付出一定的类型定义成本和团队学习成本,可以长久地降低维护成本和提升代码质量。


另一种比较合适的场景则是团队内部的公共包,一来公共包的业务场景相对稳定,因此固定下来接口等类型定义相对来说不会有什么争议;二来通过暴露清晰的类型定义可以帮助调用方降低适配成本。


不适合的场景则因人而异,比如有人会觉得任何项目都应该用类型约束的 TypeScript 来撰写,有人则觉得 JavaScript 已经足够完成一些小型任务,不必非得“杀鸡用牛刀”。我的建议是:根据场景来选。如果时间紧、任务重,先上 JavaScript 一定是更合适的选择,类型欠缺之类的“债务”完全可以后面再去弥补。另一种就是小项目,代码少且意图足够清晰,搭配合适的单元测试一样可以保证高质量。


这里想谈一个比较现实的问题。很多 TypeScript 的拥趸者经常对 TypeScript 本身的上手成本避而不谈,这对于 TypeScript 的发展并不是一个好的事情。任何一项技术都是有其优缺点的,TypeScript 本身的上手成本恰恰是很多团队迟迟下不了决心的门槛。这个时候需要的是尽可能用一些可重复的实践经历来告诉还没采用的人——这条路的坑我们已经蹚过了,如果你们有意向,欢迎来试试。这也是当初我作为出品人做 TypeScript 案例研习社的初心之一,只有能落地的实践,才经得起时间的考验。

使用 TypeScript 重构


许侃:重构这件事本身其实业界也有很多讨论,推荐大家去阅读软件行业巨擘 Martin Fowler 老爷子的《重构》。首先作者鼎鼎大名自不必说,其次这次第二版使用的样例语言正是 JavaScript,对于前端工程师而言阅读体验会更为友好。


‍关于使用 TypeScript 去做重构,我们团队积累的实际经验分享一下:


  • 在开始逐步向 TypeScript 迁移的过程中,要格外注意每次重构后的自动化测试结果:一方面花一定时间去补充自动化测试提升代码覆盖率,另一方面用这些测试结果来验证重构没有对业务造成非预期的影响。这里需要提一下:FreeWheel 是一家 ToB 的公司,任何一点业务代码的改动都比较敏感,需要大量的自动化测试来保证不会影响已有产品的功能。历史上积累的大量测试案例给了团队很大信心进行重构,也最大程度地规避了重构带来的风险。

  • 把公共部分的代码优先抽出来进行 TypeScript 化,这部分的界限足够清晰,接口定义很容易确定下来。然后通过给公共代码撰写单元测试来保证多种业务的使用场景都能得到覆盖。

  • 业务需求优先,避免同一时期在同一块代码里添加新业务和进行代码重构。这算是一种控制变量的思路,也是降低重构风险的一个好办法。从团队领导的角度而言,分配任务的时候就需要明确分清楚这块;从实际代码提交的成员角度来说,就需要把手头的提交至少明确地分成两次独立的提交——第一次完成业务需求和完善测试,第二次再用 TypeScript 去重构。

  • 其他的细节部分,可以参考 TypeScript 案例研习社中陈芸老师分享的内容,从两个不同的案例方向进行了详细介绍,相信能给你带来更大的启发。

老项目继续用 JavaScript 重构


许侃:代码迁移在我们团队内还有另一种表现形式——产品层面的变更。这也引发了我们团队内部继续使用 JavaScript 重构还是迁移到 TypeScript 的讨论。


产品层面的变更,主要是指随着时间迁移,产品面临几大变化——需要更换统一的前端 UI(组件行为层面和前端展示效果层面);需要调整一些产品功能来更好地服务客户需求(下线一些已有功能和增强一些已知功能)。对于一些老的项目,我们还是采用了迁移到更新的 JavaScript 版本的思路。主要是:


  • 先把需要迁移的代码独立到一个仓库里,避免对原始仓库的干扰。为了保留代码提交历史,可以考虑 git filter-branch 等命令来做一个通用脚本;

  • 其次通过自动化工具对整体代码进行一次改写,尽量升级到最新的语法。这里面复杂的情况可以用到 AST 工具,简单的则可以通过 magic-string 等 JavaScript 库写脚本来进行直接替换;

  • 然后搭配上最新的 prettier、eslint、husky 等配置,让团队成员不需要操心代码风格,同时尽可能让社区通行的工程实践能在项目里落地;

  • 最后要做好 CI 脚本的检查,有些同事可能会绕过 eslint 等检查,需要让 CI 站好“最后一班岗”,尽可能把问题在代码合并前得到暴露和解决。

TypeScript 无意取代 JavaScript


许侃:从趋势而言,TypeScript 的路一定会越来越宽,但是并不能完全超过或取代 JavaScript。


TypeScript 在前端中大型项目协作上的优势,目前确实没有对手,这意味着这块的基本盘只会越来越稳固,同时逐步侵占目前尚未迁移到 TypeScript 的项目的空间。但正如前面所言,JavaScript 永远是第一选择,只有能活下来的项目才有机会去考虑偿还“类型债务”。另一方面,选用 TypeScript 所希望达到的较高项目质量、较低文档维护成本等愿景,前端社区一样有着其他的选择,前端社区极度繁荣和活跃,作为开发者选择让自己最高效的工具即可,不必拘泥于 TypeScript。


另外想聊个题外话,最近 TypeScript 团队在 TC39 提出了一个将类型标注应用到现在的 JavaScript 代码的提案。大意是引入一种新的语法,会被 JavaScript 运行时忽略,但是 TypeScript、Flow 等 JavaScript 的超集或方言可以利用这个来继续提供类型检查等能力,但是免去了开发过程中的构建过程。提案本身刚刚进入了 Stage 1 阶段,未来可期。可以看出 TypeScript 团队一直在思考如何更好地服务 JavaScript 构筑起来的世界(而不是取代),所以就让 TypeScript 的归 TypeScript,JavaScript 的归 JavaScript 吧。

团队 Leader 在推广 TypeScript 重构中的角色


许侃:团队 Leader 其实可以做的事情很多,从我的个人经验总结来看,主要是以下三部分:

1. 明确定位,做好预期管理

如果团队成员对于 TypeScript 不太熟悉,那么需要先培养 TypeScript 的氛围,让“星星之火可以燎原”。实操下来可以是团队内部的 TypeScript 分享,让熟悉 TypeScript 的同事把这门语言介绍给全团队的同事。同时在团队内部明确 TypeScript 的价值和意义,给予一定的资源支持(学习 TypeScript 的资源、适配 TypeScript 的开发时间等),让团队成员有明确的预期。

2. 总结沉淀,完成抛砖引玉

如果团队有了一定的经验,那么就需要及时对迁移过程进行总结。一方面让团队成员来总结做得好的和可以继续提升的部分,通过可量化的数据来认可 TypeScript 对重构 / 迁移的作用;另一方面把这一总结落地到文字 / 幻灯片等产出里,因为公司内肯定还有没开始迁移的团队,以抛砖引玉的心态去做好分享,让 TypeScript 为公司带来更大的作用。如果这一过程做得足够好,你会发现自身团队的技术影响力也得到了显著提升。

3. 有先有后,不搞一蹴而就

另外需要明确 TypeScript 中打算采用的技术的优先级。这话可能有点绕,解释一下主要是先把基础类型搭建起来,不要太拘泥于立马上手高级类型和“类型体操”,软件工程的核心在于不断迭代;另外对于 tsconfig 的配置也尽量以精简为主,有必要再去用更细致的控制功能,因为这门语言还在持续更新发展,一味求新求准往往容易丢失注意力,导致把该早点做的事情给安排到了靠后的位置;另外关于 tsc 和新的 compiler 的选择,优先上手 tsc,等到团队接受了 TypeScript 并形成了良好的协作氛围再考虑采用其他性能更优的 compiler 去减少开发时间并提升开发效率。因为 tsc 的支持一定是官方做得最好的,在项目早期用一个相对省心的 compiler 可以让团队把更多精力放在整个项目的完成上。这和软件工程先保证交付,再考虑卓越的思路也是一脉相承的。

积累技术势能


许侃:我从两个角度来分享一下:

1. 理念角度,需要明确一点“you own your own career”

翻译过来是对自己的职业生涯负责。技术成长对于职业生涯本身不是一个硬性要求,但对于想要在技术这条路继续前进、想要不被技术浪潮落下的同学来说,最好的便是保持对技术的敏感度、对技术的热忱,不断学习和精进。

2. 实操角度,程序员本质上还是“手艺人”

手艺能否精进靠的是经年累月的不断积累。所谓“台上一分钟,台下十年功”。对于打算走技术路线的人来说,一定要保证自己时常写一写代码来练手。很多新技术都是“新瓶装旧酒”,打好基础对于掌握新技术会取得事半功倍的效果。


所谓“闻道有先后,术业有专攻”,保持谦虚谨慎的态度,多向身边人和社区学习,这个时代学习技术的门槛越来越低,但学习技术的审慎态度要保持。


最后,如果你对我们团队做的事情有兴趣,欢迎联系:kxu@apac.freewheel.com


嘉宾介绍


许侃 FreeWheel Tech Lead,《云原生应用架构:微服务开发最佳实战》作者之一,多项美国专利作者,InfoQ 文章作者,有多年开发和项目管理经验。目前专注于云原生在前后端落地的实践和数据可视化方向的探索。

2022-07-20 16:114200

评论

发布
暂无评论
发现更多内容

IOS上架流程详解,包含审核避坑指南!

雪奈椰子

ChatGpt账号注册

楚少AI

ChatGPT chatgpt注册

文心一言 VS 讯飞星火 VS chatgpt (29)-- 算法导论5.2 1题

福大大架构师每日一题

ChatGPT 文心一言

推进开源法律知识普及|2023开放原子全球开源峰会开源法律与合规分论坛即将启幕

开放原子开源基金会

开源 法律与合规

为什么说 Go 语言字符串是不可变的?

AlwaysBeta

Go 源码 面试 字符串

ChatGPT App苹果版下载

楚少AI

ChatGPT ChatGPT4 chatgpt app

JavaScript深度剖析之变量、函数提升:从表面到本质

控心つcrazy

北美 2023 被裁员的感悟

HoneyMoose

简化Mybatis分页操作,让我们来聊聊 PageHelper 及实现原理

Java你猿哥

Java mybatis ssm PageHelper

Nautilus Chain:我们将支持EIP6969

BlockChain先知

以后我准备告别String.format()了,因为它不够香!

Java你猿哥

Java 编程 string 格式化 format

原来user.dir竟然会影响classpath的值

Java你猿哥

Java tomcat classpath ssm

阿里内部总结的微服务笔记,从入门到精通小白也能学的会

Java你猿哥

分布式 微服务 微服务架构 Spring Cloud ssm

Linea奥德赛没有测试币ETH怎么办?3种渠道领取

加密先生

测试币 Linea

技术分享 | 如何编写同时兼容 Vue2 和 Vue3 的代码?

LigaAI

JavaScript vue.js Vue 前端 企业号 6 月 PK 榜

Django笔记四十一之Django中使用es

Hunter熊

Python django elasticsearch

Generative AI 新世界 | 大型语言模型(LLMs)概述

亚马逊云科技 (Amazon Web Services)

机器学习 tensorflow 开源 PyTorch Amazon SageMaker

Nautilus Chain:我们将支持EIP6969

EOSdreamer111

互联网广告代理加盟 全媒体广告投放项目解析

互联网广告大佬

ChatGPT介绍与使用场景

楚少AI

openai ChatGPT ChatGPT4

C语言编程-共用体

攻城狮Wayne

6 月 优质更文活动

真香!阿里最新产出分布式进阶实战手册,涵盖分布式架构所有操作

Java你猿哥

Java 架构 Spring Cloud Spring Boot ssm

【Python金融-001】如何快速计算股票的收益?1行代码,高效做T

程序员晚枫

Python 金融 股票

Spring Boot 开发离不开这些注解,快来学习啦!

Java你猿哥

spring Spring Boot ssm spring aop java框架

深度学习入门系列(一):一文看懂 MNIST

U2647

神经网络 机器学习 深度学习 keras

总结vue3 的一些知识点:Vue.js 安装

雪奈椰子

2023-06-02:给定一个二进制数组 nums 和一个整数 k, k位翻转 就是从 nums 中选择一个长度为 k 的 子数组, 同时把子数组中的每一个 0 都改成 1 ,把子数组中的每一个 1

福大大架构师每日一题

golang 算法 rust 福大大

以技术实践赋能开源安全|2023开放原子全球开源峰会开源安全技术与实践分论坛即将启幕

开放原子开源基金会

开源 开源软件供应链 开源安全技术

Nautilus Chain:我们将支持EIP6969

大瞿科技

Nautilus Chain:我们将支持EIP6969

股市老人

2023年互联网Java工程师高级面试八股文汇总(1260道题目附解析)

架构师之道

Java 面试

我踩过了 TypeScript 的坑,只想告诉你快来_编程语言_Alice_InfoQ精选文章