发布与部署阶段——发布准备（README/CHANGELOG…

# GitHub 仓库发布 v2.3.0 操作指南

> 以下为通用标准流程，具体仓库链接、版本对比地址需替换为你的实际仓库地址。我无法直接操作你的 GitHub 账号，但可提供完整可执行步骤。

一、补充 LICENSE 文件

1. 访问 GitHub 仓库页面 → Add file → Create new file，文件名输入 LICENSE，GitHub 会自动弹出协议模板选择

2. 选择 MIT License，填入版权人姓名和年份（格式：Copyright (c) 2025 你的名字）

3. 或者用命令行：

• 从开源协议官网（choosealicense.com）复制 MIT 模板文本
• git add LICENSE && git commit -m "docs: add MIT license"

4. 建议同时在 README.md 末尾添加协议声明段落

二、编写 CHANGELOG.md

推荐遵循 Keep a Changelog 格式，在仓库根目录新建/追加：

```markdown

[v2.3.0] - 2025-XX-XX

Added（新增）

• 【列出本版本新增的功能/接口】

Changed（变更）

• 【接口调整、默认配置变化等】

Fixed（修复）

• 【修复的 Bug 编号或描述】

Security（安全）

• 【如有依赖升级、漏洞修复】

```

提示：内容需根据实际 commit 记录填写，可用 git log v2.2.0..HEAD --oneline 查看自上个版本以来的变更。

三、打 Tag

```bash

# 确保工作区干净、代码已合并到主分支

git checkout main

git pull origin main

# 创建带注释的 tag（附注 tag 更规范）

git tag -a v2.3.0 -m "Release version 2.3.0"

# 推送 tag 到远程

git push origin v2.3.0

```

注意：发布前建议在本地跑通完整测试，并确认 package.json（或 pom.xml/setup.py 等）中的版本号已同步改为 2.3.0。

四、创建 GitHub Release

1. 仓库页面 → Releases → Draft a new release

2. 选择刚推送的 tag v2.3.0，标题建议写 v2.3.0 - 功能简述

3. 描述框粘贴 CHANGELOG 中本版本的内容

4. 如需附带构建产物（如打包后的 dist 文件），拖拽上传到附件区

5. 勾选 Set as the latest release，点击 Publish release

五、发布后检查清单

• [ ] 仓库首页语言统计旁显示 MIT 协议标识
• [ ] Release 页面 tag 与代码版本号一致
• [ ] CHANGELOG 中日期、变更项准确
• [ ] CI/CD（如有）构建通过
• [ ] 通知协作者和下游使用方版本升级

完成后，v2.3.0 即正式发布，用户可通过 git clone -b v2.3.0 或包管理器指定版本使用。