如何基于XDG标准在Debian包构建与安装后统一引用文件？

以下是一个创建包含2个文件的简单测试包的最小可行示例（MWE）：

$ cat hello.sh 
#!/usr/bin/sh
cat mydatafolder/data.txt

$ cat mydatafolder/data.txt 
Hello World!

hello-world-1.0 $ tree -L 1
.
├── debian
├── hello.sh
└── mydatafolder

3 directories, 1 file

我需要让相同的代码在构建包过程中和安装包之后都能正常引用data.txt，该怎么做？

我的尝试如下：

hello-world-1.0$ cat debian/install 
hello.sh usr/bin
mydatafolder/* usr/share/mydatafolder

hello-world-1.0$ echo $XDG_DATA_DIRS 
/usr/share/gnome:/usr/local/share/:/usr/share/

构建并安装包后，执行脚本出现错误：

$ hello.sh
cat: mydatafolder/data.txt: No such file or directory

位于/usr/share/下的mydatafolder难道不应该出现在$XDG_DATA_DIRS的目录列表中吗？难道不是这样工作的吗？

问题原因 #

你误解了XDG_DATA_DIRS的作用：它是系统用来查找数据文件目录前缀的列表，不是让脚本里的相对路径直接生效。脚本中直接写mydatafolder/data.txt是相对当前工作目录的路径，和XDG规范没有关联。

解决方案 #

要同时兼容构建时和安装后的场景，需要修改脚本逻辑，动态适配数据文件的路径：

1. 修改脚本，支持XDG标准查找

更新hello.sh，让它先尝试从开发目录加载（构建阶段用），如果找不到再从XDG_DATA_DIRS中遍历查找：

#!/usr/bin/sh
# 优先尝试开发目录下的文件（构建时使用）
DATA_FILE="./mydatafolder/data.txt"

# 如果开发目录文件不存在，遍历XDG_DATA_DIRS查找安装后的文件
if [ ! -f "$DATA_FILE" ]; then
    for dir in ${XDG_DATA_DIRS//:/ }; do
        DATA_FILE="$dir/mydatafolder/data.txt"
        if [ -f "$DATA_FILE" ]; then
            break
        fi
    done
fi

# 检查是否找到文件并执行
if [ -f "$DATA_FILE" ]; then
    cat "$DATA_FILE"
else
    echo "错误：未找到data.txt文件" >&2
    exit 1
fi

2. 确认安装路径符合XDG规范

你的debian/install配置是正确的：/usr/share/mydatafolder属于XDG_DATA_DIRS默认包含的/usr/share目录，安装后系统会自动通过XDG路径找到该目录下的文件。

3. 构建过程的兼容

在构建包时，脚本的工作目录就是包的根目录，所以./mydatafolder/data.txt会直接找到开发版本的文件，无需额外配置。

额外优化：用环境变量灵活控制路径 #

如果需要更灵活的路径控制，可以在脚本中支持环境变量覆盖：

#!/usr/bin/sh
# 优先使用环境变量指定的路径
DATA_FILE="${MY_APP_DATA:-./mydatafolder/data.txt}"

# 如果环境变量路径不存在，再遍历XDG_DATA_DIRS查找
if [ ! -f "$DATA_FILE" ]; then
    for dir in ${XDG_DATA_DIRS//:/ }; do
        DATA_FILE="$dir/mydatafolder/data.txt"
        if [ -f "$DATA_FILE" ]; then
            break
        fi
    done
fi

if [ -f "$DATA_FILE" ]; then
    cat "$DATA_FILE"
else
    echo "错误：未找到data.txt文件" >&2
    exit 1
fi

这样在构建时如果需要指定其他测试路径，只需设置MY_APP_DATA环境变量即可，比如：

MY_APP_DATA="/tmp/test-data/data.txt" ./hello.sh

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