frpc-desktop自动化版本号管理：使用standard-version

frpc-desktop自动化版本号管理：使用standard-version

在开源项目开发中，手动管理版本号和更新日志不仅繁琐，还容易出错。本文将介绍如何在frpc-desktop项目中集成standard-version工具，实现版本号自动递增、CHANGELOG.md自动生成和Git标签自动创建，让版本管理流程化、标准化。

版本管理痛点与解决方案

开发团队在版本迭代时经常面临以下问题：

• 手动修改package.json中的版本号容易遗漏
• 更新日志（CHANGELOG.md）格式不统一，关键变更记录不全
• Git标签（Tag）创建与版本号不一致

standard-version是一个遵循语义化版本（SemVer）和Conventional Commits规范的自动化工具，通过分析提交信息自动完成：

• 版本号递增（major.minor.patch）
• CHANGELOG.md文件生成与更新
• Git标签创建与提交

环境准备与依赖安装

frpc-desktop项目使用npm作为包管理器，首先需要安装standard-version作为开发依赖：

npm install standard-version --save-dev

安装完成后，可在package.json的devDependencies中看到新增的依赖项：

"devDependencies": { // 其他依赖... "standard-version": "^9.5.0" }

配置standard-version

添加npm脚本

在package.json的scripts字段中添加版本发布命令：

"scripts": { // 其他脚本... "release": "standard-version" }

创建配置文件

项目根目录下创建.versionrc.js配置文件，自定义版本管理行为：

module.exports = { types: [ { type: 'feat', section: '✨ 新功能' }, { type: 'fix', section: '🐛 修复' }, { type: 'docs', section: '📝 文档' }, { type: 'style', section: '💄 样式' }, { type: 'refactor', section: '♻️ 重构' }, { type: 'perf', section: '⚡️ 性能优化' }, { type: 'test', section: '✅ 测试' }, { type: 'build', section: '🔨 构建' }, { type: 'ci', section: '🔧 CI' }, { type: 'chore', section: '🚀 构建/依赖' }, { type: 'revert', section: '⏪️ 回滚' } ], commitUrlFormat: 'https://gitcode.com/GitHub_Trending/fr/frpc-desktop/commit/{{hash}}', compareUrlFormat: 'https://gitcode.com/GitHub_Trending/fr/frpc-desktop/compare/{{previousTag}}...{{currentTag}}' }

提交规范与版本升级

符合规范的提交信息格式

standard-version通过解析提交信息决定版本号变更：

• fix: 修复登录窗口闪退问题→ 补丁版本（patch）+1
• feat: 添加暗黑模式支持→ 次要版本（minor）+1
• feat: 重构代理配置模块+BREAKING CHANGE: 配置文件格式变更→ 主要版本（major）+1

执行版本发布

完成功能开发和规范提交后，运行以下命令执行版本发布：

npm run release

该命令会自动完成：

1. 更新package.json中的version字段
2. 生成/更新CHANGELOG.md文件
3. 创建Git提交（"chore(release): 1.2.3"）
4. 创建Git标签（v1.2.3）

集成到构建流程

frpc-desktop使用electron-builder进行打包，可在package.json的release脚本中集成版本管理：

"scripts": { "release": "standard-version && electron-builder --mac --win --linux -p always" }

版本发布流程可视化：

常见问题解决

版本号未更新

检查package.json是否设置了"private": true（如package.json第9行），standard-version默认会跳过私有包的版本更新，需在.versionrc.js中添加：

{ "private": false }

CHANGELOG为空

确保提交信息符合Conventional Commits规范，可使用commitlint工具强制校验提交信息格式：

npm install @commitlint/cli @commitlint/config-conventional --save-dev

创建commitlint.config.js：

module.exports = { extends: ['@commitlint/config-conventional'] }

总结

通过集成standard-version，frpc-desktop实现了版本管理的全自动化，主要收益：

• 开发效率提升：减少80%的版本管理手动操作
• 版本规范统一：严格遵循SemVer语义化版本
• 协作成本降低：清晰的更新日志减少团队沟通成本

完整实现可参考项目源码：

• 版本配置：.versionrc.js
• 构建脚本：package.json
• 版本服务：electron/service/VersionService.ts

建议团队在开发流程中加入commitlint和husky，进一步规范提交信息，确保版本管理工具正常工作。