Kazumi 在 Linux 下打不开、提示存储初始化失败三步找到 xdg-user-dirs 并修好【免费下载链接】Kazumi基于自定义规则的番剧采集APP支持流媒体在线观看支持弹幕支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi你看到的那一幕在 Gentoo 上双击打开 Kazumi界面刚加载就卡在内部错误弹窗标题是无法初始化本地存储正文给出一个存储路径并提示可在退出后删除该目录以重置本地数据按钮只有一个退出程序。翻终端输出和日志文件反复出现getApplicationSupportDirectory调用失败、Failed to create directory这类字样。 注意这不是网络问题也不是登录态问题——程序还没走到请求 Bangumi 数据那一步它是在找自己家的环节就摔了。我一步步排除了什么先怀疑权限。用ls -ld ~/.local/share ~/.config看目录权限结果都正常排除。再看目录本身。ls ~/.local/share/发现里面根本没有 Kazumi 的数据目录。程序连目录都没建出来就报错了说明问题出在路径没拿到而不是拿到了但写不进去。跑一条小命令验证。在终端执行下面这行xdg-user-dir DATA正常系统会回吐一个路径比如/home/用户名/.local/share。我的 Gentoo 直接回我找不到命令。对就是它——系统里压根没有提供这条命令的组件。回到代码对质。在 pubspec.yaml 里确认 Kazumi 依赖的是path_provider插件它在 Linux 上的实现方式是调用xdg-user-dir命令来询问标准路径而这条命令由xdg-user-dirs包提供。包不在询问落空插件只能回退到硬编码的兜底路径——在精简系统上这个兜底路径常常创建不了于是你在启动时看到的就是那个内部错误框。代码里的对应页面是 lib/pages/error/storage_error_page.dart目录结构的说明可参考 static/doc/STRUCTURE.md。真正卡在哪一句话说清说白了XDG 是 Linux 定的一套家规——应用数据统一放~/.local/share/、配置放~/.config/、缓存放~/.cache/而xdg-user-dirs就是负责回答标准目录到底在哪的那个组件。没有它应用等于问了一圈没人应答最后只能瞎猜地址。装上它问题就解了。三条命令搞定按你的发行版选一组Gentoosudo emerge xdg-user-dirsDebian / Ubuntusudo apt install xdg-user-dirsFedora / openSUSE 等 RPM 系sudo dnf install xdg-user-dirs装完之后统一再执行# 1. 初始化/刷新标准目录配置 xdg-user-dirs-update # 2. 验证应输出一个具体目录路径而不是command not found xdg-user-dir DATA验证通过后再启动 Kazumi~/.local/share/io.github.Predidit.Kazumi/应当被正常创建。如果程序之前已经往错误位置写过数据把它手动挪过去或者删掉那个错误目录让它重新初始化本地收藏、历史记录会随之清零注意先确认里面没有你需要的东西。顺便提醒一句如果你在做发行版打包记得在包元数据里显式声明对xdg-user-dirs的依赖别指望用户自己排查到这一步。如果你用的是Gentoo 最小安装或精简容器环境这类基础组件最容易被漏装遇到应用启动即报路径/存储错误时先查它。另外 Wayland 还是 X11 跟这个问题无关桌面环境不会改变xdg-user-dir是否存在的判定。【免费下载链接】Kazumi基于自定义规则的番剧采集APP支持流媒体在线观看支持弹幕支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考