Expert in NixOS-specific decla…

# NixOS 23.11 + Home-Manager 排查 Firefox 书签重置问题

一、问题根因分析

书签每次启动被重置，通常由以下原因导致：

• 重复管理冲突：Firefox 的 profile 目录同时被 home-manager 的 programs.firefox 模块和手动/同步方式管理，启动时声明式配置覆盖了本地数据
• profiles 声明错误：在配置中声明了 profiles.xxx 但未正确设置 isDefault，或声明了一个全新 profile 导致 Firefox 每次使用新建的空 profile
• impermanent storage（如 tmpfs / ephemeral root）：系统采用无状态根分区，而 home-manager 并未对 Firefox 数据目录做持久化或持久白名单，重启后 ~/.mozilla 被清空
• 误用 settings 当状态：settings 只能管偏好设置，书签若想声明式管理需用专门选项

二、正确声明式写法

方案 A：声明式管理书签（推荐书签固定场景）

```nix

programs.firefox = {

enable = true;

profiles.default = {

isDefault = true; # 必须设置，避免生成新空 profile

id = 0;

bookmarks = {

nixos = {

name = "NixOS 手册";

url = "https://nixos.org/manual";

};

toolbar.nixpkgs = {

name = "Nixpkgs";

url = "https://search.nixos.org/packages";

};

};

};

};

```

注意：声明式书签由 home-manager 托管，之后在 Firefox 里手动新增的书签属于正常行为，不会被“重置”，只是托管条目会随配置同步。

方案 B：保留本地书签（推荐日常使用场景）

不要声明 profiles 下的 bookmarks，只保留：

```nix

programs.firefox.enable = true;

```

让 Firefox 数据目录 ~/.mozilla 完全由其自行管理。

持久化排查（如使用了 impermanence）

在 impermanence 配置中把以下路径加入持久化白名单：

• ~/.mozilla
• ~/.cache/mozilla（可选）

三、验证步骤

1. 运行 home-manager switch（或重建 NixOS generation）

2. 检查 ~/.mozilla/firefox/profiles.ini，确认默认 profile 的 Path 与配置中 id 对应的 profile 一致

3. 启动 Firefox 添加书签，重启验证是否保留

4. 若仍异常，查看 home-manager switch 输出及 journalctl --user 日志定位冲突

四、常见坑

• 同一台机器混用 programs.firefox（系统级）与 home-manager 模块会造成双重管理，二选一
• enableGnomeExtensions 等旧选项在 23.11 已变动，升级配置时注意报错提示