Nix `nix-collect-garbage` 命令完全指南:安全清理 Nix Store 与旧 profile 代际

发布时间:2026/11/17 6:39:25

Nix `nix-collect-garbage` 命令完全指南:安全清理 Nix Store 与旧 profile 代际 开发工具CLI【免费下载链接】nixNix, the purely functional package manager项目地址https://gitcode.com/gh_mirrors/ni/nix点击查看免费下载nix-collect-garbage是 Nix纯函数式包管理器中用于清理 Nix Store 的便捷工具它在nix-store --gc的垃圾回收能力之上额外提供了删除旧 profile 代际generation的能力从而释放更多磁盘空间。本文以官方命令参考文档为主体结合本仓库中该命令的 C 实现源码src/nix/nix-collect-garbage/nix-collect-garbage.cc与 profile 代际管理实现src/libstore/profiles.cc系统讲解其工作原理、全部选项、profile 搜索范围、等价命令关系及底层 GC 机制帮助你安全、高效地完成系统清理。命令概览nix-collect-garbage的完整语法如下nix-collect-garbage [--delete-old] [-d] [--delete-older-than period] [--max-freed bytes] [--dry-run]从功能上看该命令大部分是nix-store --gc的别名——它同样会删除 Nix Store 中所有不可达unreachable的 store object即 store 路径从而清理系统。所谓不可达指的是无法通过一组被称为GC roots垃圾回收根的引用从文件系统层面触及的 store 对象而可达的对象live永远不会被删除否则会破坏系统一致性——已安装的应用可能引用 store 中已不存在的内容。与nix-store --gc的关键区别在于nix-collect-garbage额外提供了两个选项--delete-old与--delete-older-than它们会先删除旧 profile 代际再进行垃圾回收。由于 profile 本身也是垃圾回收根删掉旧代际后原本被它们引用的 store 对象将变为不可达从而允许 GC 删除更多内容。与nix-env --delete-generations的等价关系--delete-old与--delete-older-than两个选项本质上等价于先在多个 profile 上执行nix-env --delete-generations的各类参数然后再执行不带任何标志的nix-collect-garbage或直接nix-store --gcnix-collect-garbage选项等价操作--delete-old/-d对每个找到的 profile 执行nix-env --delete-generations old--delete-older-than period对每个找到的 profile 执行nix-env --delete-generations period其中old表示删除除当前代际之外的所有代际。注意由于可以回滚到之前的代际比当前代际更新的代际同样会被删除这正是 delete-generations.md 中明确警告过的行为。period形如30d表示删除创建时间早于 30 天的所有代际但保留在那个时间点处于活动状态的那一代以便仍可回滚到该时间段内的状态。重要警告官方文档明确提示了两点务必在使用前理解删除旧代际会使回滚到这些时间点变得不可能。代际是回滚的载体一旦删除就无法恢复。这些标志应谨慎使用因为它们可能删除系统上其他用户所使用的 profile 代际——nix-collect-garbage会跨多个用户目录搜索 profile详见下文并非只针对当前用户。搜索 profile 的位置nix-collect-garbage无法获知系统上所有的 profile该信息并不存在它只会在若干固定位置查找并处理找到的所有 profile默认 profile 位置由 profiles 文档 规定即普通用户$XDG_STATE_HOME/nix/profilesroot用户$NIX_STATE_DIR/profiles/per-user/root已废弃的旧版路径官方标注Not stable; subject to change仅供迁移用途属 Nix 私有实现细节未来可能变更不应依赖$NIX_STATE_DIR/profiles$NIX_STATE_DIR/profiles/per-user除$NIX_STATE_DIR/profiles/per-user/root和$NIX_STATE_DIR/profiles/default外这些目录已不再被其他命令使用。nix-collect-garbage仍会检查它们目的是清理旧版本 Nix 遗留的 profile。在源码层面这一逻辑体现在 nix-collect-garbage.cc 的main_nix_collect_garbage中当指定了删除旧代际的标志时程序构造一个待清理目录集合dirsToClean包含profilesDir(profilesDirOpts)默认 profile 根目录、settings.nixStateDir / profiles以及默认 profile 的父目录getDefaultProfile(profilesDirOpts).parent_path()然后对每个目录递归调用removeOldGenerations(dir)。removeOldGenerations的实现细节值得注意若目录不可读access(..., R_OK)失败则直接跳过递归遍历子目录对符号链接且目录可写W_OK的条目读取其链接目标只有当目标路径中包含子串link时才视为 profile 代际链接并处理对应profile-N-link命名约定若指定了--delete-older-than则调用deleteGenerationsOlderThan(path, t, dryRun)否则调用deleteOldGenerations(path, dryRun)每次遍历迭代都会调用checkInterrupt()以便在收到中断信号时安全退出。profile 的文件系统布局节选自 profiles.md形如profile是指向profile-N-link的符号链接而profile-N-link又是指向 store 中某路径的符号链接。每个这样的符号链接都是 Nix 垃圾收集器的一个根因此删除代际链接会直接改变 GC 的可达性判定。选项详解以下选项用于在删除不可达 store 对象之前删除旧 profile 代际。--delete-old/-d删除所有找到的 profile 的旧代际即除当前代际外的所有代际。等价于对每个找到的 profile 调用nix-env --delete-generations old。在源码中解析到--delete-old或-d时置位removeOld true。--delete-older-thanperiod删除早于指定时间的所有 profile 代际但保留在那一时间点处于活动状态的代际。period是诸如30d这样的值表示 30 天。等价于对每个找到的 profile 调用nix-env --delete-generations periodperiod 参数的更多细节可参考 delete-generations.md。从源码看period 的解析由 profiles.cc 中的parseOlderThanTimeSpec完成以d结尾否则报错invalid number of days specifier提示应类似14d前部必须是合法的正整数天数days 1返回当前时间 - days * 24 * 3600秒级时间戳。随后deleteGenerationsOlderThan按代际创建时间lstat得到的st_mtime见findGenerations从新到旧扫描找到第一个早于目标时间的代际后保留其前一代即那个时间点活跃的代际以便回滚再删除其余所有更早的代际当前代际除外。findGenerations通过解析profile名-数字-link的命名模式来识别代际编号。--max-freedbytes持续删除路径直到至少释放bytes字节后停止。bytes可附带乘法后缀K、M、G或T分别表示 KiB、MiB、GiB、TiB。该选项直接透传给底层 GC 的GCOptions.maxFreed字段默认值为UINT64_MAX即不设上限由 gc-store.hh 中的GCOptions结构承载。源码中通过getIntArgint64_t解析并以std::max(..., 0)保证非负。--dry-run只报告将要删除的内容而不真正删除。其行为在源码中体现为底层 GC 动作由gcDeleteDead实际删除切换为gcReturnDead仅返回死路径集合结果仍通过printFreed打印将释放的字节数profile 代际删除走deleteGeneration2的 dry-run 分支仅打印would remove profile version Nprofiles.cc。注意--dry-run与--max-freed不能同时使用——源码中两者同时出现时会抛出UsageError(options --max-freed and --dry-run cannot be combined)。公共选项与环境变量与大多数 Nix 命令一样该命令还接受 公共选项--help、--version、-v/--verbose、--quiet、--log-format、--option等与 公共环境变量。与本文主题直接相关的环境变量包括NIX_STATE_DIR覆盖 Nix 状态目录位置影响$NIX_STATE_DIR/profiles等搜索路径的解析NIX_STORE_DIR覆盖 Nix Store 的位置NIX_REMOTE覆盖store配置决定 GC 作用于哪个 store。底层 GC 流程nix-collect-garbage在完成代际清理后会打开默认 storeopenStore()通过requireGcStore要求其支持垃圾回收然后执行gcStore.collectGarbage(options, results)。相关类型定义在 gc-store.hhGCAction枚举gcReturnLive返回从根可达的路径闭包、gcReturnDead返回不可达路径、gcDeleteDead实际删除不可达路径默认动作、gcDeleteSpecific仅删除指定列表中的不可达路径GCOptions包含action、maxFreed、pathsToDelete整店删除WholeStore或指定路径SpecificPaths、ignoreLiveness等GCResults返回删除的路径集合与释放的字节数bytesFreed。nix-collect-garbage始终以WholeStore整店方式执行并配合--max-freed控制停止时机。回收器完成或被中断时会打印释放的总字节数例如8825586 bytes freed (8.42 MiB)见 gc.md 示例。此外GC 行为还受 Nix 配置文件中的keep-outputs默认false与keep-derivations默认true两个设置影响详见 垃圾回收指南默认值保证所有作为 GC 根构建时依赖的 derivation 会被保留所有作为运行时依赖的 output 也会被保留其余内容才会被回收。使用示例删除 Nix Store 中不被各 profile 当前代际使用的所有内容并同时清理所有旧代际$ nix-collect-garbage -d这是官方文档给出的一键清理标准做法-d先在各 profile 上等效执行nix-env --delete-generations old随后执行完整 GC。其他常见用法# 仅清理 30 天前的旧代际 完整 GC $ nix-collect-garbage --delete-older-than 30d # 限制本次 GC 最多只释放约 100 MiB $ nix-collect-garbage --max-freed $((100 * 1024 * 1024)) # 先演练一遍看看会删除什么 $ nix-collect-garbage --dry-run延伸更细粒度的控制若需要比nix-collect-garbage更细的控制可直接使用其底层命令nix-store --gc提供--print-roots打印 GC 根、--print-live打印可达路径、--print-dead打印将删除的路径子操作以及--max-freed选项nix-env --delete-generations支持按代际编号列表如3 4 8、old、numberd按天数与number保留最近 N 代等多种方式精确管理单个 profile 的代际需要彻底回收空间时可配合nix-store --optimise进行 store 内的硬链接去重或参考 垃圾回收指南 中的完整清理流程先删旧代际、再执行 GC。建议将nix-collect-garbage -d或--delete-older-than 30d纳入定期维护任务如 cron / systemd timer以避免 store 无限膨胀对于多用户共享机器优先使用--delete-older-than而非--delete-old以减少误删他人可用代际的风险。赞分享开发工具CLI【免费下载链接】nixNix, the purely functional package manager项目地址https://gitcode.com/gh_mirrors/ni/nix点击查看免费下载相关推荐nixpkgs构建缓存清理nix-collect-garbage使用指南nixpkgs构建缓存清理nix collect garbage使用指南 你是否遇到过NixOS系统磁盘空间持续增长的问题随着软件包的频繁更新和构建系统会包管理器操作系统NixOS/nix项目深入解析nix-store --query命令完全指南NixOS/nix项目深入解析nix store query命令完全指南 引言为什么需要深入了解nix store query 你是否曾经在使用Nix包管开发工具CLINix nix-store --realise 命令完全指南构建与获取 store objects 的核心机制Nix nix store realise 命令完全指南构建与获取 store objects 的核心机制 本指南以 Nix 官方手册中 nix store开发工具CLI上一篇终结重复代码Awesome Claude Code资源覆盖机制终极指南下一篇2025 Rust算法调试指南从零配置VS Code完美开发环境创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/17 8:23:51

定海区电工证怕考不过白交培训费?掌握这些技巧含金量翻倍

定海区电工证怕考不过白交培训费?掌握这些技巧含金量翻倍 怕考不过白交培训费?你不是一个人。每年成千上万的电工从业者因为备考不当,花了几千块的培训费,最后还是没通过考试,白白浪费时间和金钱。特别是定海区电工证,作为特种作业操作证中的一类,含金…

2026/11/17 8:23:50

低压电工证只考理论吗 电子证书报名流程全解析

低压电工证只考理论吗 电子证书报名流程全解析 你是不是也和很多人一样, 不知道去哪报名怕被中介坑 ,尤其是想考低压电工证,听说要考试,但不清楚是考理论还是实操?更不知道现在报名流程是怎样的,电子证书又怎么获取?别急,这篇文章给你讲清楚。…

2026/11/17 8:23:50

清溪电工证怎么查询网上查不到别慌 这样操作能解决90%问题

清溪电工证怎么查询网上查不到别慌 这样操作能解决90%问题 实操考试心里没底怕挂科,清溪电工证怎么查询网上查不到?你不是一个人在战斗。很多人第一次报考特种作业操作证,尤其是像低压电工、高压电工这类需要实操考试的证书,总会担心自己能不能顺利通…

2026/11/17 8:23:50

平湖交通学校电工证多久拿证?证书过期了别慌,全流程教你搞定

平湖交通学校电工证多久拿证?证书过期了别慌,全流程教你搞定 证书过期了不知道怎么复审延期,是不是你最近正在经历的烦心事?特别是对于从事电工工作的朋友来说,特种作业操作证是上岗的“通行证”,一旦过期,不仅影响日常工作,还可能面临违规操作的风险…

2026/11/17 8:18:47

电工证怎办,怕考不过白交培训费?保姆级教程来了

电工证怎办,怕考不过白交培训费?保姆级教程来了 你是不是也在为“电工证怎办”这个问题发愁?怕花钱报了培训班,最后还是考不过,白交了钱?别急,今天我就用保姆级教程,带你从头到尾搞清楚电工证怎么考、怎么准备,还有那些你可能没听过的避坑经验。…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑