JaydenAI的博客

Monorepo 项目是一种将多个相关应用、服务或库统一存放在同一个代码仓库的管理方式。它不同于传统的多仓库（Polyrepo），通过集中化的结构提升协作效率。在 monorepo 中，所有项目共享统一的依赖、构建工具和配置文件，开发者可以跨项目进行原子化提交和大规模重构，避免版本冲突。常见目录结构包括 packages/ 存放公共库、apps/ 存放应用，以及统一的 tsconfig.base.json 和 pnpm-workspace.yaml。这种模式在大型团队和复杂系统中尤为常见，

在 TypeScript 中，`Symbol` 是 ES6 引入的一种原始数据类型，与 `number`、`string`、`boolean` 等基础类型并列。它表示一个**独一无二、不可变**的值，通常被用作对象属性的键，以确保属性名不会发生冲突。

JavaScript 在代码模块化方面有着悠久的历史，并衍生出多种不同的方法。TypeScript 自 2012 年问世以来，已经实现了对许多模块化格式的支持，但随着时间的推移，社区和 JavaScript 规范最终都采用了名为 ES Modules（或 ES6 Modules）的格式。您可能熟悉它的 import/export 语法。ES Modules 于 2015 年被添加到 JavaScript 规范中，到 2020 年，它已在大多数 Web 浏览器和 JavaScript 运行时环境中得到广泛支持

TypeScript 完全支持 ES2015 中引入的 `class` 关键字。与其他 JavaScript 语言特性一样，TypeScript 添加了**类型注解**和其他语法，使你能够表达类与其他类型之间的关系。

在基于VS项目中，一个典型的项目结构包含了源码、包管理、编译器配置和环境定义文件。它以 app.ts 为核心，通过 npm run build 将业务逻辑编译为可运行的 app.js。同时，编译器会自动提取不含运行逻辑的 app.d.ts 声明文件，作为“说明书”为其他模块提供类型类型检查与代码补全。为了解决“开发与运行环境不一致”的问题，项目引入 app.js.map 作为翻译桥梁，让开发者在 VS 中能直接基于 .ts 源码进行丝滑断点调试；而 tsconfig.json 的严格模式则在编译期提前拦截

TypeScript 的类型系统非常强大，因为它允许用其他类型来表示类型。这种理念最简单的形式就是泛型。此外，我们还可以使用各种各样的**类型运算符**。也可以用已有的值来表示类型。通过组合各种类型运算符，我们可以以简洁、易于维护的方式表达复杂的操作和值。

本文介绍了TypeScript中对象类型的三种定义方式（接口、类型别名、匿名类型），以及对象属性的修饰符和特性。重点讲解了可选属性（使用?）、只读属性（readonly）和索引签名的使用场景与注意事项。特别强调了额外属性检查机制，包括通过类型断言、索引签名或中间变量来绕过检查的方法。文章还指出，数字索引器返回的类型必须是字符串索引器返回类型的子类型，并解释了只读属性的实际限制。这些特性帮助开发者更安全地定义和使用对象类型。

函数是任何应用程序的基本构建块，无论是本地函数、从其他模块导入的函数，还是类中的方法。它们也是值，就像其他值一样，TypeScript 提供了多种方式来描述函数的调用方式。让我们来学习如何编写描述函数的类型。

联合类型 A | B 表示一个值可能是 A 或 B，从集合论角度看是类型集合的并集，但它不会把成员结构合并，而是保持“二选一”的语义。所以当我们将一个变量声明为联合类型的时候，在默认的情况下只有针对**交集**数据成员的访问是安全的。为了不仅限于访问联合类型的交集成员，但是**并集**成员范围又太宽，在编程的时候我们需要引入响应的条件判断，缩小成员的范围，使针对某些API的访问控制在一个安全的边界之内，我们将其称为类型收窄（Narrowing）。

本文介绍了TypeScript中的九种基本类型及其使用方式，包括原生类型（字符串、数字、布尔值）、数组、any类型、函数、对象、联合类型、类型别名、接口以及类型断言。还详细讲解了如何通过上下文类型推断减少显式注解，使用可选属性和联合类型增加灵活性，以及通过类型别名和接口简化复杂类型的定义。最后，说明了类型断言的作用和使用时的限制。

tsc 是 TypeScript 的官方编译器，它的作用就是把 .ts 文件编译成标准的 .js 文件，供浏览器或 Node.js 执行。核心功能包括 类型检查、语法转换、配置驱动和增量编译等。