Linux下stow单向映射dotfiles时出现目录异常问题咨询

• 核心差异来自Linux设备上的GNU Stow版本或本地配置：
  1. 若你Linux上的Stow版本为2.3.0，该版本存在已知回归bug：未显式指定--adopt参数时，处理目标路径$HOME下已存在的非软链接目录（比如$HOME/.config），会错误执行类似收养逻辑，将目标目录下的原有文件/文件夹移动到Stow管理的dotfiles目录中，再创建软链接，直接对应你观察到的异常现象。
  2. 若Linux上Stow版本≥2.3.1，大概率是本地Stow配置文件被注入了--adopt参数：Stow运行时会默认读取~/.stowrc以及执行命令时当前工作目录下的.stowrc配置，即使脚本里写了绝对路径调用Stow，配置文件里的参数也会生效。
• Mac设备无异常的原因：macOS上通过Homebrew等渠道分发的Stow要么跳过了存在bug的2.3.0版本，要么默认配置文件中没有--adopt相关配置，因此行为符合预期。

• 前置操作：先全量备份你的dotfiles目录和$HOME/.config目录，避免后续操作误删配置。之后把dotfiles目录下多出来的、原本属于$HOME/.config的文件/文件夹移回原路径，注意不要覆盖你已经在dotfiles中维护的自定义配置。
• 版本与配置排查：
  1. 执行stow --version查看当前版本：如果输出为2.3.0，直接升级Stow到2.3.1及以上稳定版即可：Debian/Ubuntu系执行sudo apt update && sudo apt install --only-upgrade stow，Arch系执行sudo pacman -Syu stow。
  2. 如果版本已经高于2.3.0，检查~/.stowrc和脚本执行时工作目录下的.stowrc文件，删除其中所有--adopt相关的配置行。
• 脚本优化，避免后续复发：
  1. 不要用$(pwd)获取dotfiles路径，改为自动读取脚本所在目录的绝对路径，避免执行脚本时工作目录异常导致参数错误。
  2. 显式添加--no-adopt参数，强制关闭收养逻辑，覆盖配置文件中的异常设置。
     优化后的核心脚本片段：

  # 自动获取脚本自身所在目录作为dotfiles根路径，不依赖执行时的工作目录
  DOTFILES="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  # 显式关闭adopt逻辑，增加verbose日志方便排查
  /usr/bin/stow -v --stow --no-adopt --ignore ".DS_Store" --target="$HOME" --dir="$DOTFILES" files
  

• 结构校验：确认你的Stow管理目录结构符合要求：如果要管理.config下的配置，需要在$DOTFILES/files下手动创建.config子目录，再将nvim、i3、alacritty等配置目录放入files/.config/路径下，不要直接将配置目录放在files根目录，否则会被错误软链接到$HOME根目录而非$HOME/.config下。

内容的提问来源于stack exchange，提问作者jrock2004