本地GitLab仓库占用过大空间，如何高效留存并优化性能？

一、Git仓库本身的瘦身操作 #

• 清理Git冗余对象
  执行git gc --aggressive --prune=all，深度清理仓库中未被引用的提交、旧分支、标签及冗余对象文件，通常能释放大量空间，建议每个仓库定期运行一次。
• 启用稀疏检出（Sparse Checkout）
  若项目包含大量无需本地存储的目录（如庞大文档库、第三方依赖包目录），可只检出必要代码目录：
  1. 开启稀疏检出：git config core.sparseCheckout true
  2. 在.git/info/sparse-checkout文件中添加需保留的目录，例如：

     src/
     config/
     package.json
     

  3. 更新本地文件：git read-tree -mu HEAD
     操作后本地仅下载指定目录，大幅减少存储空间占用。
• 清理Git LFS缓存
  若用Git LFS管理大文件，执行git lfs prune删除当前分支未引用的LFS对象；日常拉取时用git lfs fetch --recent仅获取最近需要的大文件，避免缓存过多历史大文件。
• 共享Git对象库（多仓库场景）
  若多个仓库属于同一项目的不同分支/衍生版本，可通过共享对象库减少重复存储：
  1. 先克隆基础仓库：git clone <repo-url> main-repo
  2. 克隆其他仓库时用共享模式：git clone --shared ./main-repo other-repo
     多个仓库会共享.git/objects目录，节省大量重复空间。

二、VSCode端性能优化 #

• 精简扩展
  禁用不常用的扩展，尤其是会全局扫描仓库文件的代码分析、搜索类工具，减少后台资源占用。
• 配置文件排除规则
  在VSCode的settings.json中添加排除项，让VSCode跳过对大目录、临时文件的索引和扫描：

  {
    "files.exclude": {
      "**/node_modules": true,
      "**/dist": true,
      "**/build": true,
      "**/*.log": true
    },
    "search.exclude": {
      "**/node_modules": true,
      "**/dist": true
    }
  }
  

• 调整Git自动扫描设置
  关闭不必要的Git实时扫描：

  {
    "git.autorefresh": false,
    "git.detectDeletedFiles": false
  }
  

  需要查看Git状态时手动点击状态栏Git图标刷新即可。
• 使用工作区统一管理多仓库
  将所有需要的仓库添加到同一个VSCode工作区（File > Add Folder to Workspace），避免打开多个VSCode窗口，降低内存和CPU消耗。

三、系统层面辅助优化 #

• 迁移到SSD存储
  将仓库移至SSD，即使占用空间大，SSD的高速读写也不会导致系统卡顿——机械硬盘的随机读写慢是大仓库引发性能问题的常见原因。
• 启用磁盘压缩
  Windows系统可右键仓库文件夹 > 属性 > 高级 > 勾选“压缩内容以节省磁盘空间”；Mac系统可使用APFS的文件压缩功能，牺牲少量CPU性能换取存储空间，对SSD用户影响极小。
• 定期清理临时依赖目录
  用脚本或包管理工具定期清理node_modules、vendor等依赖目录，比如执行npm ci重新安装依赖时会自动清理旧目录，或用rm -rf node_modules && npm install手动清理。

内容的提问来源于stack exchange，提问作者DevLearner