通过 npm link 实现本地共享库调试，修改即时生效；2. 稳定后发布至私有仓库或 Git 托管，便于版本管理；3. 配置 tsconfig 路径映射提升 VSCode 开发体验；4. 高度关联项目推荐 Monorepo 架构统一管理。
在多项目开发中，经常需要复用一些通用代码，比如工具函数、配置文件、组件或服务类。为了减少重复、提升维护效率，可以通过合理的共享库设计和依赖管理机制实现跨项目代码复用。以下是一套基于 VSCode 和现代 Node.js 生态的实用方案。
1. 使用 npm link 实现本地包共享
将通用代码封装为独立的 npm 包，并通过 npm link 在多个项目中引用，是本地开发阶段最直接的方式。
- 创建共享库目录（如
my-utils），初始化为 npm 包：npm init - 确保
package.json中定义了正确的name和main字段 - 在共享库根目录运行：
npm link，将其注册到全局链接系统 - 进入目标项目目录，执行：
npm link my-utils
此后，项目中可像普通模块一样导入：import { helper } from 'my-utils'。修改共享库代码后，项目立即生效，适合调试。
2. 私有 NPM 仓库或 Git 托管发布
当共享库趋于稳定，建议通过私有包管理方式统一发布与更新。
- 使用 Verdaccio 搭建轻量级私有 npm 仓库
- 或将共享库推送到 GitHub/GitLab，通过 Git URL 安装：
npm install git+https://github.com/user/my-utils.git - 支持指定分支或标签：
npm install git+https://github.com/user/my-utils.git#v1.0.0
这种方式便于版本控制和团队协作，VSCode 能正常跳转定义、提示类型，前提是共享库包含 TypeScript 声明文件（.d.ts）或内联类型。
3. 配置 TypeScript 路径映射提升开发体验
在使用共享库时，可通过 tsconfig.json 的路径映射优化导入路径并支持智能提示。
- 在项目根目录的
tsconfig.json中添加：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@lib/*": ["../my-utils/src/*"]
}
}
}
这样可以在代码中使用别名导入：import { log } from '@lib/logger'，VSCode 能正确解析路径并提供导航功能。
4. 利用工作区（Monorepo）简化管理
对于高度关联的多个项目，推荐使用 Monorepo 架构统一管理共享代码。
- 使用 pnpm workspace 或 yarn workspace 组织项目结构
- 目录示例：
workspace/ ├── packages/ │ ├── shared/ │ │ └── package.json │ ├── app-a/ │ │ └── package.json │ └── app-b/ │ └── package.json └── package.json
在根 package.json 中定义 workspaces 后，安装时会自动软链依赖，shared 可被 app-a 和 app-b 直接引用，且支持热更新。VSCode 打开根目录即可跨项目跳转、搜索和重构。
基本上就这些。根据团队规模和项目复杂度选择合适方案：小型团队可用 npm link + Git 托管；中大型项目建议采用私有仓库或 Monorepo 架构。关键是保持接口清晰、版本可控，让 VSCode 充分发挥编辑优势。不复杂但容易忽略。
