spotDL 升级 v4.4.3 后 Linux 配置文件路径在哪里旧路径如何兼容【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloader在 Linux 上把 spotDL 升级到 v4.4.3 或更高版本后配置文件不再放在老位置~/.spotdl/config.json而是迁移到了 XDG 标准路径~/.config/spotdl/config.json。本文基于项目文档docs/usage.md、docs/installation.md、docs/troubleshooting.md说明升级后配置文件到底在哪里、旧路径下已有的配置如何被继续读取以及如何确认配置生效。升级 spotDL 到 v4.4.3 及以上版本前置条件来自 docs/installation.mdPython 3.10 - 3.14已加入 PATH、FFmpeg 4.2 或更高版本。非 Windows 系统如 Linux执行命令时把pip换成pip3、python换成python3。pip install --upgrade spotdl升级 v4.4.3 时还有一个依赖注意点v4.4.3 要求 ytmusicapi 最低版本为 v1.11.1。如果遇到KeyError: header这类 YouTube Music API 报错按 docs/troubleshooting.md 的处理方式升级依赖pip install -U ytmusicapi若报错持续再强制重装 spotDLpip install -U --force spotdlv4.4.3 之后 Linux 上的配置文件位置根据 docs/usage.md 的 “Config file location” 一节WindowsC:\Users\user\.spotdl\config.jsonLinuxv4.4.3 起~/.config/spotdl/config.json文档同时注明v4.4.3 之前Linux 的默认位置是~/.spotdl/config.json且当新目录不存在时旧位置仍会被使用。路径选择的实际逻辑可以在 get_spotdl_path 中核对Linux 下按以下顺序解析~/.config/spotdl已存在 → 使用新路径新路径不存在、但~/.spotdl存在 → 继续使用旧路径即老用户的配置原地生效无需手动迁移两个目录都不存在全新用户→ 创建并使用~/.config/spotdl。也就是说升级后 spotDL 会自动“认得”你在旧路径下的配置只要新目录没有被创建旧文件就继续被使用。确认当前使用的是哪个路径文档没有提供专门的“打印配置路径”命令可以按文档描述的行为来核对检查两个目录哪个存在ls -d ~/.config/spotdl ~/.spotdl 2/dev/null只有~/.spotdl存在说明你在用旧路径配置~/.spotdl/config.json升级后行为不变~/.config/spotdl也存在新路径优先配置读取的是~/.config/spotdl/config.json两个都不存在下次运行 spotDL 时会创建~/.config/spotdl。配置文件在已存在的情况下会被自动加载也可以用--config参数显式指定从配置文件下载歌曲。如果不想让配置自动加载把配置文件中的load_config改为false{ load_config: false }重新生成配置文件如果需要在新路径生成一份默认配置运行spotdl --generate-config注意文档明确提示该命令会覆盖已有的配置文件执行前确认当前配置路径下不需要保留的手改项。生成后可以打开对应路径下的config.json核对内容默认配置样例见 docs/usage.md 的 “Default config” 一节包含client_id、audio_providers、output、threads等字段。一个文档内不一致的地方docs/usage.md 中--config参数的帮助文本仍写着“~/.spotdl/config.jsonunder linux”与同文件 “Config file location” 一节给出的~/.config/spotdl/config.json不一致。判断实际读取位置时建议以 “Config file location” 一节和 spotdl/utils/config.py 中的get_spotdl_path逻辑为准。适用范围与限制本路径规则针对 v4.4.3 及以上版本当前仓库中版本号已推进到 4.5.0见 spotdl/_version.py规则同样适用。旧路径兼容是“新目录不存在则回退到旧目录”并非自动迁移一旦~/.config/spotdl被创建读取的将是新路径下的配置旧路径文件不会被合并过来。如需把旧配置带到新路径需自行复制文件仓库文档未提供迁移命令此处只提示行为差异不额外给出操作步骤。【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考