Rust项目（Bevy引擎）占用大量磁盘空间的原因及优化方法

一、临时清理现有构建产物 #

• 执行 cargo clean 可直接删除当前项目的target目录，快速释放空间。若要清理所有Cargo全局缓存（包括依赖构建产物），可使用 cargo clean --all，但注意这会导致后续构建需重新编译所有依赖，速度会变慢。

二、全局Cargo配置优化（所有Rust项目通用） #

在用户目录下创建 .cargo/config.toml 文件，添加以下配置来减少调试符号体积、优化缓存策略：

1. 控制调试符号生成

   [profile.dev]
   # 完全关闭调试符号，体积骤减但无法调试代码
   debug = false
   # 或保留基础调试能力同时缩减体积：debug = "limited"
   

2. 限制增量构建缓存时长
   增量构建能加快后续编译，但会占用额外空间，可设置缓存过期时间：

   [build]
   incremental = true
   # 缓存保留7天（单位：秒）
   incremental-cache-timeout = 604800
   

3. 压缩调试符号
   针对Linux/macOS等支持的平台，可让Cargo自动打包压缩调试符号：

   [profile.dev]
   debug = true
   debug-assertions = true
   split-debuginfo = "packed"
   

三、项目级Cargo.toml配置（仅当前Bevy项目生效） #

Bevy默认开启大量调试特性，可在项目的Cargo.toml中针对性优化：

1. 禁用不必要的Bevy特性
   仅保留Pong游戏必需的特性，去掉默认的debug特性以减少调试信息生成：

   [dependencies]
   bevy = { version = "0.12", default-features = false, features = ["dynamic_linking", "render", "core_pipeline", "sprite", "input", "window"] }
   

2. 优化dev编译配置
   覆盖默认的dev profile设置，平衡体积与编译速度：

   [profile.dev]
   # 轻度优化，减小体积且编译速度下降不明显
   opt-level = 1
   # 保留有限调试符号
   debug = "limited"
   split-debuginfo = "packed"
   incremental = true
   

四、其他实用技巧 #

• 使用cargo sweep工具：第三方工具，可自动清理旧构建产物。安装后执行 cargo sweep -t 7d 即可删除7天前的构建缓存。
• 启用动态链接：在Bevy特性中加入dynamic_linking，多个Bevy项目可共享同一依赖的构建产物，减少重复占用空间。

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