编写Linux个人配置文件符号链接管理脚本的最优方案

我目前用GNU stow管理配置文件，它能把集中存储的配置文件夹自动创建符号链接到对应使用目录。但stow有冗余功能，配置管理逻辑也不符合我的需求，所以想自己写简易脚本。一开始选Bash是因为新系统不用额外依赖，但写完的脚本很难维护，不确定是Bash不适合还是我的实现方式有问题。现在想请教：

1. 有没有更优的Bash实现思路？
2. 有没有能分担逻辑的CLI工具？
3. 如果Bash不合适，除了Python（不考虑），哪种语言更合适？我目前倾向Go。

附上我的Bash脚本：

#!/usr/bin/env bash

set -euo pipefail

DRY_RUN=0
VERBOSE=0

declare -A VISITED
declare -A STACK

log() {
    if [[ "$VERBOSE" -eq 1 ]]; then
        echo "[INFO] $*"
    fi
}

run() {
    if [[ "$DRY_RUN" -eq 1 ]]; then
        echo "[DRY-RUN] $*"
    else
        eval "$@"
    fi
}

stow_directory() {
    local sourceDir="$1"
    local targetDir="$2"
    local relativePath="${3:-}"

    local dir_id
    dir_id=$(stat -c "%d:%i" "$sourceDir")

    if [[ -n "${STACK[$dir_id]:-}" ]]; then
        echo "[ERROR] cycle detected at: $sourceDir" >&2
        return 1
    fi

    if [[ -n "${VISITED[$dir_id]:-}" ]]; then
        return 0
    fi

    STACK["$dir_id"]=1

    local sourceDirBase
    sourceDirBase=$(basename "$sourceDir")

    local fullTargetDir
    fullTargetDir="${targetDir%/}/${relativePath#/}"
    fullTargetDir="${fullTargetDir%/}"

    log "Processing dir: $sourceDir -> $fullTargetDir"

    run "mkdir -p '$fullTargetDir'"

    # Symlink files
    shopt -s nullglob
    # Symlink files
    shopt -s nullglob
    for file in "$sourceDir"/*; do
        [[ -e "$file" ]] || continue
        [[ -d "$file" ]] && continue

        local target_file="$fullTargetDir/$(basename "$file")"

        log "Link file: $file -> $target_file"

        run "ln -sfn '$file' '$target_file'"
    done
    shopt -u nullglob

    # Recurse directories
    for subDir in "$sourceDir"/*/; do
        [[ -d "$subDir" ]] || continue

        local subBase
        subBase=$(basename "$subDir")

    local newRelativePath="${relativePath%/}/$subBase"
    stow_directory "$subDir" "$targetDir" "$newRelativePath"
    done

    unset STACK["$dir_id"]
    VISITED["$dir_id"]=1

    return 0
}

stow_recursively() {
    local sourceDir="$1"

    if [[ -f "$sourceDir/.stow" ]]; then
        local targetDir
    targetDir="$(eval echo "$(cat "$sourceDir/.stow")")"

        log "Found .stow in $sourceDir -> $targetDir"

        stow_directory "$sourceDir" "$targetDir" ""
        return 0
    fi

    shopt -s nullglob
    local subdirs=("$sourceDir"/*/)
    shopt -u nullglob

    if [[ ${#subdirs[@]} -eq 0 ]]; then
        return 1
    fi

    for subDir in "${subdirs[@]}"; do
        stow_recursively "$subDir"
    done

    return 0
}

print_help() {
    cat <<'EOF'
Usage:
  stow.sh [options] [sourceDir]

Options:
  --dry-run     Show what would be done without making changes
  --verbose     Print detailed logs of operations
  --help        Show this help message

Behavior:
  Recursively searches for directories containing a ".stow" file.
  When found, reads the target directory and symlinks contents into it.

Example:
  ./stow.sh --verbose .
  ./stow.sh --dry-run ~/dotfiles
EOF
}

main() {
    local sourceDir=""

    while [[ $# -gt 0 ]]; do
        case "$1" in
            --dry-run) DRY_RUN=1 ;;
            --verbose) VERBOSE=1 ;;
            --help|-h)
                print_help
                return 0
                ;;
            *) sourceDir="$1" ;;
        esac
        shift
    done
    
    sourceDir="$(realpath "$sourceDir")"

    log "Starting from: $sourceDir"

    if stow_recursively "$sourceDir"; then
        return 0
    fi

    echo "no valid stow file" >&2
    return 1
}

if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
    main "$@"
fi

解答 #

1. 更优的Bash实现思路 #

你的现有脚本逻辑没问题，但可从以下几点优化维护性：

• 拆分函数职责：把路径处理、符号链接创建、配置读取这些逻辑拆成独立小函数，比如单独写read_stow_config读取.stow文件，resolve_target_path处理路径拼接，避免单个函数太冗长。
• 避免eval风险：当前读取.stow文件用了eval echo，如果文件里有特殊字符会触发意外执行，改用printf "%s" "$(cat "$sourceDir/.stow")"后再用realpath解析，既支持~这类路径，又更安全。
• 简化递归逻辑：用find命令代替手动递归遍历目录找.stow文件，比如find "$sourceDir" -type f -name ".stow"，直接获取所有目标目录，减少递归函数的复杂度。
• 错误处理强化：在关键步骤（比如创建目录、符号链接）后检查返回值，set -e虽能终止脚本，但可以添加更明确的错误提示，方便调试。
• 变量作用域明确：所有函数内的变量都用local声明，避免全局变量污染，当前脚本里stow_recursively中的targetDir漏了local，需要修正。

2. 可分担逻辑的CLI工具 #

• find + ln组合：系统自带工具就能完成核心逻辑，比如用find定位.stow文件，再逐行读取目标路径执行链接操作，减少脚本里的递归代码。
• rsync：如果需要同步逻辑辅助，rsync的--link-dest参数可处理文件硬链接，但仅需符号链接时，find+ln更直接。
• coreutils工具集：mkdir -p、realpath这些工具都是系统标配，可直接用来简化路径处理和目录创建逻辑，无需自己实现复杂判断。

3. 替代Bash的语言选择 #

Go是非常合适的选择，理由如下：

• 编译型无依赖：编译后是单二进制文件，和Bash一样能在新系统直接运行，无需额外安装环境。
• 标准库强大：path/filepath包处理路径、os包操作文件系统、flag包处理命令行参数，都能轻松实现你的需求，且类型安全，避免Bash里的变量类型问题。
• 维护性高：结构化代码、错误处理明确，比Bash脚本更容易扩展功能（比如后续加删除链接、批量操作）。
• 跨平台：如果以后需要在Windows等非Linux系统运行，Go编译的程序能直接适配，而Bash依赖POSIX环境。

其他可选语言：

• Rust：和Go类似，编译后无依赖，性能更好，但学习曲线稍陡，若只是写简单工具，Go的语法更简洁。
• Lua：轻量，很多系统自带Lua解释器，语法简洁，但处理文件系统需要依赖第三方库，不如Go的标准库直接。

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