Hy语言版本管理与兼容性指南

Hy语言版本管理与兼容性指南

hy A dialect of Lisp that's embedded in Python 项目地址: https://gitcode.com/gh_mirrors/hy/hy

版本号规范

Hy语言从1.0.0版本开始采用语义化版本控制规范(SemVer)。语义化版本号由三个数字组成，格式为MAJOR.MINOR.PATCH：

• MAJOR版本号变更表示包含不兼容的API修改
• MINOR版本号变更表示新增向后兼容的功能
• PATCH版本号变更表示向后兼容的问题修正

Python版本兼容性

Hy语言支持所有当前维护中的CPython版本，包括Linux、Windows和macOS平台。同时也支持PyPy的最新版本。

需要注意的是，Hy语言与大多数Python包不同，通常需要针对每个新的Python 3.x版本进行适配调整。当CPython官方停止维护某个Python版本后，Hy可能会在后续版本中放弃对该Python版本的支持。

这种Python版本兼容性的调整不会导致Hy主版本号的变更，但至少会更新次版本号。项目配置中会明确指定兼容的Python版本范围，防止用户在不兼容的Python环境中安装Hy。

版本昵称机制

从Hy 1.0.0开始，每个正式版本都会有一个昵称，例如"Afternoon Review"。这些昵称按字母顺序排列，从"A"开始到"Z"后循环。虽然昵称主要是为了增加趣味性，但也可以作为快速识别版本的有效方式。

在代码中，可以通过hy.nickname获取当前Hy版本的昵称字符串。对于未发布的开发版本，该值为None。

升级注意事项

当Hy主版本号变更时，通常意味着存在不兼容的API修改。建议用户：

1. 仔细阅读版本变更说明
2. 在开发环境中先测试升级
3. 按照变更说明调整代码
4. 确认所有功能正常后再部署到生产环境

对于次版本号和小版本号的升级，通常可以直接进行，但建议仍保持谨慎态度。

开发版本使用

使用Hy的开发版本(非正式发布版本)时需要注意：

1. API可能不稳定
2. 功能可能发生变化
3. 可能存在未修复的问题
4. 缺少版本昵称标识

建议生产环境使用正式发布的稳定版本。

通过理解Hy语言的版本管理策略，开发者可以更好地规划项目升级路径，确保代码兼容性和稳定性。

hy A dialect of Lisp that's embedded in Python 项目地址: https://gitcode.com/gh_mirrors/hy/hy