04 项目结构与组织

项目结构与组织 #

良好的项目结构有助于维护大型 TypeScript 项目,确保代码组织清晰。

基本概念 #

典型结构包括 src、tests、types 等目录,使用 barrel 文件(index.ts)简化导入。

使用场景 #

  • 分离业务逻辑、工具函数和类型定义。
  • 在 monorepo 中管理多个包。
  • 结合构建工具如 Webpack。

示例代码 #

示例项目结构:

project/
├── src/
│   ├── components/
│   ├── utils/
│   └── index.ts
├── tests/
├── types/
├── tsconfig.json
└── package.json

最佳实践 #

  • 使用一致的命名约定,如 kebab-case for files。
  • 避免循环依赖,通过重构模块。
  • 定期审查结构以适应项目增长。