Shellcheck提示：同一管道勿读写同一文件的含义及替代方案咨询

Hey there! Let's break down what this Shellcheck warning means and how you can fix your issue of adding a line to the start of your file.

为什么会出现这个提示？ #

当你尝试在同一个管道里同时读取和写入同一个文件时，Shell会启动多个进程并行执行管道里的命令。举个例子，假设你写了这样的命令：

echo "blah/blah" | cat - "$tmpdir/$filename.jpdf" > "$tmpdir/$filename.jpdf"

这里的核心问题是：> 重定向会立即清空目标文件来准备写入，而此时cat命令还在尝试读取这个已经被清空的文件。结果就是原文件的内容全部丢失，最后只留下你插入的那一行，甚至可能出现更奇怪的损坏情况——这就是典型的“数据竞争”问题，读写操作互相干扰，导致不可预测的文件内容。

Shellcheck的提示就是在提醒你：这种写法存在严重风险，绝对要避免。

靠谱的替代方案 #

1. 使用临时文件（跨平台最稳妥） #

先把拼接好的内容写入一个临时文件，确认写入完成后再替换原文件。这种方法所有Shell环境都支持，没有兼容性问题：

# 创建一个临时文件
temp_file=$(mktemp)

# 先写入要插入的行，再追加原文件内容
echo "blah/blah" > "$temp_file"
cat "$tmpdir/$filename.jpdf" >> "$temp_file"

# 替换原文件（仅当前面的命令都成功时执行）
mv "$temp_file" "$tmpdir/$filename.jpdf"

或者更简洁的写法，用大括号把命令组起来：

{ echo "blah/blah"; cat "$tmpdir/$filename.jpdf"; } > "$(mktemp)" && mv "$_" "$tmpdir/$filename.jpdf"

这里的$_会引用上一个命令创建的临时文件路径。

2. 使用sponge命令（简洁省心，需额外安装） #

sponge是moreutils工具包里的小工具，它会先把所有输入内容读完，再一次性写入目标文件，完美避免了同时读写的问题。安装后可以这样用：

echo "blah/blah" | cat - "$tmpdir/$filename.jpdf" | sponge "$tmpdir/$filename.jpdf"

• 如果你用Debian/Ubuntu：sudo apt install moreutils
• 如果你用macOS：brew install moreutils

3. 使用sed原地编辑（适合简单场景） #

sed的-i选项支持原地修改文件，你可以用1i命令在第一行之前插入内容：

# GNU sed（Linux系统）
sed -i '1i blah/blah' "$tmpdir/$filename.jpdf"

# BSD sed（macOS/FreeBSD），需要给-i加一个空参数
sed -i '' '1i blah/blah' "$tmpdir/$filename.jpdf"

这个方法不需要临时文件，写起来也短，但要注意不同系统的sed语法差异。

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