conventional-changelog-writer中自定义transform函数的正确用法

在conventional-changelog生态系统中，conventional-changelog-writer是一个用于生成变更日志的核心组件。最近版本中，其transform函数的实现方式发生了变化，导致一些开发者在使用自定义writerOpts时遇到了问题。

问题背景

在conventional-changelog-writer的较新版本中，commit对象被设计为不可变(immutable)的。这意味着开发者不能再像以前那样直接修改传入的commit对象属性。当尝试直接修改commit对象时，会抛出"Cannot modify immutable object"的错误。

解决方案

正确的做法是让transform函数返回一个新的对象，而不是直接修改传入的commit对象。这个新对象可以包含你想要修改的属性，其他未指定的属性将保持不变。

实现示例

以下是一个正确的transform函数实现示例：

module.exports = {
  writerOpts: {
    transform: (commit, context) => {
      // 返回新对象而不是修改原对象
      return {
        ...commit,
        type: `修改后的${commit.type}`,
        notes: commit.notes.map(note => ({
          ...note,
          title: `自定义${note.title}`
        }))
      };
    }
  }
}

关键点说明

1. 不可变原则：commit对象现在被设计为不可变的，这是现代JavaScript开发中的常见模式，有助于提高代码的可预测性和稳定性。

2. 函数式编程：transform函数应该遵循函数式编程的原则，即不产生副作用，而是返回一个新的对象。

3. 部分更新：返回的对象只需要包含需要修改的属性，其他属性会自动保留原值。

4. 深层修改：如果需要修改嵌套属性（如notes数组中的对象），也需要遵循不可变原则，使用map等函数返回新数组。

最佳实践

1. 总是返回新对象，而不是修改原对象
2. 使用展开运算符(...)来保留不需要修改的属性
3. 对于数组和嵌套对象，使用map等函数进行转换
4. 保持transform函数纯净，不依赖或修改外部状态

通过遵循这些原则，开发者可以充分利用conventional-changelog-writer的灵活性，同时避免因对象不可变性导致的运行时错误。