standard-version生成CHANGELOG报错及日志重复问题求助

我来帮你拆解这两个问题的原因和对应的解决办法：

问题1：git报错“error: pathspec 'CHANGELOG.md' did not match any file(s) known to git” #

原因分析 #

这个报错本质是git找不到CHANGELOG.md的追踪记录，常见场景有这几种：

• 这是你第一次运行standard-version，生成的CHANGELOG.md是新文件，还没被git加入追踪列表，standard-version直接尝试提交时git识别不到它；
• 文件生成路径不对，比如CHANGELOG.md没出现在git仓库的根目录（和package.json同层级）；
• Windows系统下可能存在文件名大小写问题（比如之前有过Changelog.md的记录，git缓存了旧的大小写映射）；
• git缓存异常，比如之前删除过CHANGELOG.md但没清理缓存。

解决办法 #

• 首次发布场景：运行standard-version --first-release替代yarn release，这个参数会自动处理初始CHANGELOG.md的生成、加入git追踪并完成提交；
• 手动追踪文件：先执行git add CHANGELOG.md把新生成的文件加入git追踪，再重新运行yarn release；
• 路径与大小写检查：确认CHANGELOG.md在仓库根目录，用git ls-files查看git当前追踪的文件列表，检查是否有大小写不一致的同名文件，如果有，先清理旧的缓存记录：git rm --cached Changelog.md（把旧文件名替换成实际的），再重新add新文件；
• 清理git缓存：如果是缓存问题，执行git rm --cached CHANGELOG.md（如果该文件曾被追踪过），然后重新执行git add CHANGELOG.md。

问题2：新版本发布日志重复之前的提交信息 #

原因分析 #

standard-version是基于git commit和tag来生成CHANGELOG的，重复记录通常和以下因素有关：

• 之前的release操作没有把生成的tag推送到远程仓库，导致本地下次运行时，standard-version找不到最新的基准tag，重新扫描了已经处理过的commit；
• commit信息不符合Conventional Commits规范（比如没有feat:、fix:这类前缀），导致standard-version无法正确识别哪些commit已经被收录过；
• 本地存在重复或错误的git tag，导致版本基准识别混乱；
• 多次重复执行release命令但没有清理中间生成的commit/tag，导致重复扫描。

解决办法 #

• 推送tag到远程：每次release完成后，执行git push --follow-tags，把新版本的commit和tag同步到远程，这样下次运行standard-version会基于最新的tag来筛选commit；
• 规范commit信息：确保你的commit信息遵循Conventional Commits格式，比如feat(auth): 添加登录验证、fix(api): 修复接口超时问题，这样standard-version能准确识别并分类记录，避免重复收录；
• 清理错误tag：用git tag查看本地所有tag，如果有重复或错误的版本tag，执行git tag -d <tag-name>删除，然后重新运行yarn release；
• 手动修正CHANGELOG：如果已经出现重复记录，可以手动编辑CHANGELOG.md删除重复内容，提交后，若只想更新版本而不重新生成CHANGELOG，可运行yarn release --skip.changelog（但更建议从根源解决，避免后续重复问题）。

内容的提问来源于stack exchange，提问作者SeyyedKhandon