写还是不写?作为一个团队,如何权衡自研与开源库

文化   2024-11-16 09:16   福建  

随着业务的快速发展,团队成员从各自负责不同项目到需要重新聚集在一个核心项目上工作,这种转变带来了一个重要问题:在技术实现上,应该选择现成的开源库还是自己开发?

项目成长带来的挑战

当项目逐渐扩大,需要考虑:

  1. 多个项目的整合
  2. 业务模型的提升
  3. 新用户的引入
  4. 团队协作的频率提升

这不是一件容易的事,但随着业务的发展却是必要的。因此,在某些时候,每个团队都应该开始创建自己的工具(helpers&utils),或者使用开源库中已经准备好的库。这就需要在技术选型上做出更加慎重的决策。

平衡之道 ⚖️

常见的过度使用情况

// 🚫 不推荐:为简单功能引入大型库
import jQuery from 'jquery';
$('.menu').addClass('active');

// ✅ 推荐:使用原生方法
document.querySelector('.menu').classList.add('active');

加载 jQuery,查找一些元素并为其添加类。加载 React 或 Vue,构建一个简单的新闻网站。加载 Lodash,实现一两个辅助功能。NPM 会安装一堆依赖项,这些依赖项都有自己的依赖项,因为这是你在网上读到的教程告诉你要做的。

我们采用的方法让整个生态系统变得更加缓慢和脆弱。

对于一个小的局部问题,加载一个库是一件不必要的昂贵的事情。对于大型通用问题集,唯一有效的方法,更不用说唯一合理的管理和解决方法,就是使用代码库(如 jQuery/React/Redux 等)。

技术选型决策矩阵

团队中的每一个人都曾经使用过某样东西,并确切地知道它是如何工作的。但时间在变,业务在变,需求也在变。因此,通过遵循以下原则,使用它才是正确的选择。

  1. 开发时间 vs 维护时间
// 简单功能自己实现
const formatDate = (date) => {
  return new Date(date).toLocaleDateString();
};

// 复杂功能使用成熟库
import moment from 'moment';
moment(date).format('YYYY-MM-DD');
  1. 简单性 vs 灵活性
// 简单错误处理自己实现
class SimpleError extends Error {
  constructor(message: string, code?: number) {
    super(message);
    this.code = code;
  }
}

// 复杂错误处理使用库
import { CustomError } from 'ts-custom-error';
  1. 大任务 VS 小任务

是否面临着一项艰巨的任务,需要外部代码来解决?肯定是的,AMQP 或 SQL 操作都是太大的任务,不需要从头开始开发,但微小的日志记录可以就地解决。不要使用外部库来解决小任务。

  1. 无我 VS 只为耍酷

你们的写作方式可能与其他人不同,我的解决方案可能与你们的不同,但希望作为一个团队,我们能互相提供想法,并指导团队其他成员成为更好的开发人员。

决策清单 📝

在选择技术方案时,需要考虑以下几点:

  1. 功能重要性评估

    // 核心功能示例:用户认证
    // 建议使用成熟库如 Auth0、Firebase Auth
    import { Auth } from '@auth0/auth0-react';

    // 非核心功能示例:简单数据转换
    // 可以自己实现
    const transformData = data => ({
      ...data,
      timestampDate.now()
    });
  2. 库的适用性分析

  • 与需求的匹配度
  • 源码的可访问性
  • 测试覆盖率
  • 可替代方案
  • 体积与功能比
  • 实际案例分析

  • // 场景:表单验证

    // 方案1:使用库
    import { useForm } from 'react-hook-form';

    // 方案2:自己实现
    const useValidation = (initialValues) => {
      const [errors, setErrors] = useState({});
      // ... 实现基本验证逻辑
    };

    // 决策依据:
    // 1. 如果只需要简单验证 -> 自己实现
    // 2. 如果需要复杂验证、性能优化 -> 使用成熟库

    最佳实践建议 🌟

    1. 建立评估机制
    interface LibraryEvaluation {
      name: string;
      bundleSize: number;
      maintainability: number;
      communitySupport: boolean;
      lastUpdate: Date;
      coverage: number;
    }

    const evaluateLibrary = (lib: LibraryEvaluation): boolean => {
      // 根据团队标准进行评估
      return lib.bundleSize < 50000 && 
             lib.maintainability > 8 &&
             lib.coverage > 80;
    };
    1. 定期回顾
    • 每季度评估已使用的库
    • 检查是否有更好的替代方案
    • 评估自研组件的维护成本
    1. 文档化决策
    # 技术选型文档模板

    ## 需求描述
    [详细描述需求]

    ## 方案对比
    方案A:使用库 X
      - 优势:[列出优势]
      - 劣势:[列出劣势]
    方案B:自研实现
      - 优势:[列出优势]
      - 劣势:[列出劣势]

    ## 最终决策
    [说明选择原因]

    记住,没有完美的解决方案,只有最适合当前团队和项目的选择。关键是要在团队内建立良好的技术决策机制,确保每个选择都经过充分的评估和讨论。


    最后:
    React Hook 深入浅出
    CSS技巧与案例详解
    vue2与vue3技巧合集
    VueUse源码解读


    大迁世界
    掘金LV8,思否10万+的作者。一个热爱前端的创业者。
     最新文章