guix <子命令> [选项] [参数]

# 按名称搜索
guix search video player

# 搜索特定名称
guix search ^vim

# 输出为 Scheme 格式
guix search vim --output-format=recutils

# 查看包的完整信息
guix show vim

# 输出示例：
# name: vim
# version: 9.0.1
# outputs: out
# source: ...
# inputs: ncurses, gpm, ...
# home-page: https://www.vim.org/
# synopsis: Text editor
# description: Vim is a highly configurable text editor...
# license: vim-license

# 查看当前 profile 中的包
guix package --list-installed

# 输出示例：
# vim    9.0.1    out    /gnu/store/...
# git    2.40.0   out    /gnu/store/...

# 不确定开发包的名称？搜索试试
guix search openssl | grep -i dev
guix show openssl
# 查看 outputs 字段：通常包含 out 和 dev

# 使用 guix search 或 guix locate
guix search "the command" provides
# 或者使用反向查找
guix package --search-paths=prefix

# 安装单个包
guix install vim

# 安装多个包
guix install git htop tree curl

# 安装特定输出（如开发头文件）
guix install openssl:dev

# 默认 profile（~/.guix-profile）
guix install vim

# 指定 profile
guix install -p ~/my-profiles/development vim python

# 为特定项目创建独立 profile
mkdir -p ~/my-profiles/project-a
guix install -p ~/my-profiles/project-a node python

;; ~/dev-tools.scm
(specifications->manifest
  '("git"
    "vim"
    "python"
    "python-pip"
    "docker-cli"
    "openssh"))

# 使用 manifest 安装
guix package --manifest=~/dev-tools.scm

# 步骤一：更新通道（拉取最新的包定义）
guix pull

# 步骤二：升级已安装的包
guix upgrade

# 只升级特定包
guix upgrade vim git

# 升级到特定版本（通过通道指定）
# 通常需要修改通道配置或使用 time-machine

# 使用特定版本的 Guix 运行命令
guix time-machine --channels=channels.scm -- install vim

# channels.scm 中可以锁定到特定 commit

# 删除单个包
guix remove vim

# 删除多个包
guix remove vim git htop

# 删除不会立即释放空间——旧版本仍在 store 中
# 需要配合垃圾回收（GC）才能释放空间

# 查看所有 generation
guix package --list-generations

# 输出示例：
# Generation 1  May 01 2026 10:00:00
#   vim   9.0.1  out
#   git   2.39.0 out
#
# Generation 2  May 05 2026 14:30:00
#   vim   9.0.2  out  (升级)
#   git   2.40.0 out  (升级)
#   htop  3.2.1  out  (新增)
#
# Generation 3  May 10 2026 09:00:00  (current)
#   vim   9.0.2  out
#   htop  3.2.1  out
#   git 已删除

# 回滚到上一个 generation
guix package --roll-back

# 切换到特定 generation
guix package --switch-generation=2

# 简写形式
guix package -S 2

# 删除特定 generation
guix package --delete-generations=1

# 删除 30 天前的 generation
guix package --delete-generations=30d

# 删除除当前外的所有 generation
guix package --delete-generations

# 发现 vim 9.0.2 有 bug
guix package --roll-back

# 或者精确回到旧版本
guix package --switch-generation=1

# 确认恢复
guix package --list-installed

# 查看 store 占用的空间
guix gc --list-dead       # 列出可回收的对象
guix gc --list-live       # 列出活跃的对象

# 执行垃圾回收
guix gc --collect-garbage
guix gc -C 5G            # 保留至少 5GB 空间

# 删除特定 store 路径
guix gc --delete /gnu/store/abc...-vim-9.0

# 标记某个 store 路径为 "根"（root），防止被回收
guix gc --referrers /gnu/store/abc...-vim-9.0

# 添加间接引用
guix gc --derivers /gnu/store/abc...-vim-9.0

# 创建目录
mkdir -p ~/profiles/dev

# 安装到自定义 profile
guix install -p ~/profiles/dev python node rust

# 激活自定义 profile
export PATH="$HOME/profiles/dev/bin:$PATH"

# 或者创建一个激活脚本
cat > ~/activate-dev.sh << 'EOF'
export PATH="$HOME/profiles/dev/bin:$PATH"
export GUIX_PROFILE="$HOME/profiles/dev"
source "$HOME/profiles/dev/etc/profile"
EOF
source ~/activate-dev.sh

;; ~/manifests/python-dev.scm
(specifications->manifest
  '("python"
    "python-pip"
    "python-virtualenv"
    "python-numpy"
    "python-pandas"
    "python-matplotlib"
    "gcc-toolchain"
    "pkg-config"))

# 使用 manifest 构建 profile
guix package --manifest=~/manifests/python-dev.scm -p ~/profiles/python-dev

# 更新 profile（从最新的 manifest）
guix package --manifest=~/manifests/python-dev.scm -p ~/profiles/python-dev --upgrade

# 创建包含 Python 的临时环境
guix shell python python-numpy -- python

# 创建纯净环境（不继承系统包）
guix shell --pure python python-numpy -- python

# 创建容器化环境（更强的隔离）
guix shell --container python -- python

;; ~/project-env.scm
(specifications->manifest
  '("python"
    "python-requests"
    "python-flask"
    "postgresql"))

# 从 manifest 创建环境
guix shell --manifest=~/project-env.scm

# 在项目目录中放置 manifest
cp ~/project-env.scm ./manifest.scm
guix shell  # 自动使用当前目录的 manifest.scm

# 从 shell 环境导出 Docker 镜像
guix shell --container --network \
  --expose=$(pwd) \
  python python-flask \
  -- guix pack -f docker -o image.tar.gz \
    python python-flask

# 1. 搜索 Python 包
guix search python | head -20

# 2. 查看 Python 包详情
guix show python

# 3. 创建开发环境
guix shell python python-numpy python-pandas -- python3 -c "
import numpy as np
import pandas as pd
print('NumPy:', np.__version__)
print('Pandas:', pd.__version__)
"

# 1. 安装一个包
guix install tree
tree --version

# 2. 删除它
guix remove tree

# 3. 确认已删除
which tree  # 应该找不到了

# 4. 回滚
guix package --roll-back

# 5. 确认恢复
which tree  # 又回来了
tree --version