GAM项目安装脚本中dist-info文件累积问题分析

问题背景

在GAM项目的安装和更新过程中，发现了一个关于Python包元数据文件(dist-info)累积的问题。当用户通过gam-install.sh脚本更新现有GAM7安装时，脚本会解压新的归档文件到目标目录，但不会清理旧的dist-info文件，导致这些文件在lib子目录中不断累积。

技术细节

问题表现

当前安装脚本的工作流程如下：

1. 创建目标目录
2. 解压归档文件到目标目录
3. 新文件会覆盖同名旧文件

然而，当Python包的版本更新时，旧的dist-info文件不会被自动删除。例如：

• 包从1.0.0升级到1.0.1时
• 新版本会创建新的dist-info目录(如package-1.0.1.dist-info)
• 但旧版本的目录(如package-1.0.0.dist-info)会保留

影响分析

虽然这些残留文件不会导致GAM运行时错误，但会带来以下问题：

1. 占用额外磁盘空间(实测可达2MB以上)
2. 可能导致包管理混乱
3. 影响用户对当前安装版本的判断

解决方案

修复方案

在解压新文件前，先清空目标目录中的lib子目录：

mkdir -p "$target_dir"
rm -fr "$target_dir/gam7/lib/*"

实现考虑

1. 安全性：添加-v参数以便在出错时查看详细操作
2. 兼容性：同时支持tar和zip格式的归档文件
3. 稳定性：确保删除操作只针对lib子目录，不影响其他文件

最佳实践建议

对于类似的项目安装脚本，建议：

1. 在更新前清理旧版本文件
2. 保留必要的配置文件
3. 提供详细的日志输出
4. 考虑添加版本校验机制

这个修复方案已被合并到GAM项目的主分支中，有效解决了dist-info文件累积的问题，使GAM的安装目录保持整洁。