VSCode-GitLens项目优化：清理未使用的媒体资源

在软件开发过程中，随着项目不断迭代，经常会积累一些不再使用的资源文件。这些"僵尸文件"不仅占用存储空间，还会增加最终发布包的体积，影响用户体验。本文以VSCode-GitLens项目为例，介绍如何通过清理未使用的媒体资源来优化VSIX扩展包。

问题背景

VSCode-GitLens是一个流行的Visual Studio Code扩展，为开发者提供强大的Git版本控制功能。在项目开发过程中，随着文档和功能的更新，会积累许多不再使用的图片等媒体资源文件。这些文件虽然不再被引用，但仍然会被打包到最终的VSIX扩展包中。

优化措施

项目团队采取了分阶段优化策略：

1. 文档图片外链化：将所有文档中的图片改为从外部CDN(raw.githubusercontent.com)加载，而不是打包到扩展中。这一步直接将VSIX包大小从28.5MB减少到7.9MB，效果显著。

2. 彻底清理未使用资源：在完成外链化后，再彻底删除项目中不再引用的所有媒体资源文件，进一步精简项目体积。

技术实现

这种优化方案有几个关键点：

1. 资源引用分析：需要全面扫描项目，确定哪些资源文件仍被代码或文档引用。

2. 渐进式优化：先处理影响最大的部分(文档图片外链化)，再处理细节(删除未使用文件)，确保每次改动都能带来明显收益。

3. 版本控制：虽然删除未使用文件，但仍需保留在版本历史中，以便必要时恢复。

优化效果

通过上述优化，项目取得了显著成效：

• VSIX包体积减少72% (28.5MB → 7.9MB)
• 提升用户下载和安装速度
• 减少扩展占用的磁盘空间
• 简化项目结构，提高可维护性

最佳实践建议

对于类似项目，建议：

1. 定期进行资源清理，避免积累过多无用文件
2. 大文件尽量使用外链而非打包
3. 建立资源使用规范，明确存放位置和引用方式
4. 在CI流程中加入包体积检查，防止体积膨胀

通过这种系统化的资源管理，可以保持项目的精简高效，为用户提供更好的使用体验。