现状
3.2.0 已于 2026-04-27 发布到 PyPI(当前 latest),git tag 3.2.0 / 3.2.0b1 也已推送,但 GitHub Releases 页面尚未创建对应 Release,"Latest" 仍停留在 3.0.4(2026-01-21)。
影响
建议一:补发 3.2.0 Release
基于 3.0.4..3.2.0 的 8 个提交整理了 release notes 草稿,供直接采用或修改。如维护者同意,我也可以协助补发:
Features
Bug Fixes
Refactor & CI
Full Changelog: 3.0.4...3.2.0
建议二:引入 tag 触发的自动发布 workflow,杜绝此类问题
当前发布流程全手动(本地 setup.py upload 传 PyPI + 手动推 tag + 网页创建 Release),三步中漏掉任何一步都不会有提示,这次就是漏了最后一步。
提议增加 release.yml,推 tag 即完成全部发布动作:
- 版本一致性校验:tag 名 ==
setup.py 的 version == constants.py 的 CLIENT_VERSION,不一致直接失败(历史上 3.2.0b1 / 3.2.0 两处均有同步,校验可行)
- 构建:
python -m build 产 sdist + wheel(顺带修正现状 --universal 产 py2.py3 通用 wheel 的问题,本包实际要求 Python 3.10+)
- 发布 PyPI:使用 Trusted Publishing (OIDC),无需在 repo 中存放任何 PyPI token
- 自动创建 GitHub Release:
--generate-notes 生成与现有 3.0.x Release 相同格式的 notes;tag 含 a/b/rc 自动标记 pre-release
需要 PyPI 项目 owner 配合的一次性配置(Trusted Publishing):
PyPI → nacos-sdk-python 项目 → Publishing → Add a new publisher(GitHub):
- Owner:
nacos-group
- Repository:
nacos-sdk-python
- Workflow name:
release.yml
- Environment name:
pypi
workflow 的 PR 随后提交,欢迎大家讨论。
现状
3.2.0已于 2026-04-27 发布到 PyPI(当前 latest),git tag3.2.0/3.2.0b1也已推送,但 GitHub Releases 页面尚未创建对应 Release,"Latest" 仍停留在3.0.4(2026-01-21)。影响
pip install nacos-sdk-python默认安装 3.2.0,但在 GitHub 上找不到对应的 release notes / changelog建议一:补发 3.2.0 Release
基于
3.0.4..3.2.0的 8 个提交整理了 release notes 草稿,供直接采用或修改。如维护者同意,我也可以协助补发:Features
Bug Fixes
nacos.server.contextPath导致注册失败的问题 (nacos server修改nacos.server.contextPath导致注册失败问题 #300, [Fix] nacos server修改nacos.server.contextPath导致注册失败问题 #300 #312)Refactor & CI
Full Changelog: 3.0.4...3.2.0
建议二:引入 tag 触发的自动发布 workflow,杜绝此类问题
当前发布流程全手动(本地
setup.py upload传 PyPI + 手动推 tag + 网页创建 Release),三步中漏掉任何一步都不会有提示,这次就是漏了最后一步。提议增加
release.yml,推 tag 即完成全部发布动作:setup.py的version==constants.py的CLIENT_VERSION,不一致直接失败(历史上3.2.0b1/3.2.0两处均有同步,校验可行)python -m build产 sdist + wheel(顺带修正现状--universal产 py2.py3 通用 wheel 的问题,本包实际要求 Python 3.10+)--generate-notes生成与现有 3.0.x Release 相同格式的 notes;tag 含a/b/rc自动标记 pre-release需要 PyPI 项目 owner 配合的一次性配置(Trusted Publishing):
workflow 的 PR 随后提交,欢迎大家讨论。