### Python代码中记录版本号和变更日志的最佳实践 在不使用Git的情况下，在Python项目中记录版本号和变更日志可以通过以下几种方式实现： #### 1. 使用配置文件存储版本信息 可以创建一个专门的模块（如`version.py`），用来定义项目的版本号和其他元数据。 ```python # version.py __version__ = "1.0.0" __release_date__ = "2023-10-01" __author__ = "Your Name" ``` 通过这种方式，可以在程序运行时轻松访问这些信息[^1]。 #### 2. 利用CHANGELOG文件记录变更日志 维护一个单独的`CHANGELOG.md`文件，按照标准化格式（如Keep a Changelog标准）记录每次发布的更新内容。每条记录应包括版本号、发布日期以及具体的改动描述。 例如： ```markdown ## [1.0.1] - 2023-10-05 ### Fixed - 解决了一个可能导致崩溃的小错误。 ## [1.0.0] - 2023-10-01 ### Added - 添加了核心功能A。 - 实现了新特性B。 ``` 这种方法便于团队成员查阅历史变动，并保持透明度[^2]。 #### 3. 将版本管理和日志集成到应用程序内部 对于更复杂的场景，考虑开发一套轻量级的版本控制系统嵌入至应用本身之中。比如每当完成一项重要修改后调用特定函数自动写入相关信息到数据库或文本文件里。 下面展示了一种简单的实现思路： ```python import datetime class VersionManager: def __init__(self, file_path="changelog.txt"): self.file_path = file_path def log_change(self, message): timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S") with open(self.file_path, 'a') as f: f.write(f"[{timestamp}] {message}\n") def main(): vm = VersionManager() # Simulate making changes and logging them. vm.log_change("Initial setup completed.") vm.log_change("Added new feature X.") if __name__ == "__main__": main() ``` 此脚本会持续追加新的活动详情到指定的日志文档当中[^3]。 #### 4. 结合自动化工具简化流程 为了减少手动干预可能带来的失误风险，还可以引入一些第三方库辅助处理此类任务。例如bump2version就是一个专为此目的设计的好帮手——它不仅能够便捷地调整包内的版本声明，而且支持自动生成相应的提交消息与标签[^4]。 ---