How to share code between TypeScript projects?

在TypeScript项目中共享代码是一个常见需求，尤其是在大型或多项目的环境中。以下是几种主流和高效的方法来实现代码共享：

1. 创建共享库

最常见也是最推荐的方式是创建一个共享的TypeScript库。你可以将通用的功能、组件、模型等封装在一个独立的库中，并通过包管理工具（如npm或yarn）来管理这个库。

步骤如下：

• 初始化库项目： 使用 npm init 或 yarn init 创建新的项目。
• 开发和构建： 在这个项目中开发你的共享代码，并使用如 tsc （TypeScript Compiler）编译。
• 发布到包管理器： 将编译后的代码发布到npm或私有的npm仓库。
• 在其他项目中引入： 在其他TypeScript项目中通过 npm install your-library-name 来安装并使用这个库。

示例：

假设你有一个函数库需要在多个项目中使用：

typescript
// src/index.ts
export function add(a: number, b: number): number {
    return a + b;
}

编译并发布后，其他项目就可以通过npm安装并使用这个函数。

2. 使用Monorepo管理项目

Monorepo是一种项目管理策略，允许你在单一的仓库中管理多个相关联的项目。这对于共享代码非常有效，因为所有项目都位于同一仓库中，共享代码变得非常直接。

工具推荐：

• Lerna： 可以帮助管理多个包的版本和依赖。
• Yarn Workspaces： 也支持多包管理，可以有效地链接各个包。

示例：

在一个使用Lerna的Monorepo中，你可以轻松地将一个包作为另一个包的依赖来引用。

3. 使用Git子模块

如果你的项目分布在不同的仓库中，可以考虑使用Git子模块来共享代码。通过Git子模块，你可以将另一个仓库作为子目录引入。

步骤如下：

• 添加子模块： 在你的主项目仓库中，使用 git submodule add <repository-url> 添加子模块。
• 更新和管理： 子模块可以独立更新，也可以随主项目一起更新。

这种方式适合共享的代码量不大，且更新频率不高的场景。

小结

每种方法都有其适用场景，选择最合适的方式取决于你的项目结构和团队工作流。创建共享库适合大多数情况，特别是当代码需要被广泛共享和复用时；Monorepo适合项目间紧密相关的情况；Git子模块则适合项目间相对独立，但仍需共享部分代码的场景。