install -T 和普通目录安装有什么区别

在 GNU install 中，普通写法和 install -T 的核心差异，不是权限参数，而是最后一个操作数的身份判断：普通写法会把目录（包括指向目录的符号链接）当作容器，把源文件名追加进去；-T 则要求把最后一个操作数当作目标文件路径处理。批量安装时，若目标一定是目录，使用 -t 会更直白。

需要把 app 安装成固定文件名时用 install -T source app；需要把一个或多个源文件放进目录时用 install -t dir source...；只有在目标语义明确且可接受目录自动判断时，才使用普通的两参数写法。

先判断：最后一个参数到底是什么

排查“文件为什么出现在意外目录”时，先不要急着改命令。先把目标分成四种情况：已经存在的普通文件、已经存在的目录、指向目录的符号链接，以及尚不存在的路径。普通 install source dest 的行为只会在最后一个参数被识别为目录或目录软链接时追加源文件名。

# 只查看类型，不修改目标路径
src="./build/myapp"
dest="/opt/demo/app"

printf '源文件：'
stat -c '%F %n' -- "$src"
printf '目标：'
if [ -e "$dest" ] || [ -L "$dest" ]; then
    # -L 让悬空软链接也能被识别，避免误把它当成不存在
    stat -c '%F %n' -- "$dest"
else
    printf '不存在 %s\n' "$dest"
fi

dest 已经是目录时，普通命令的实际目标会变成 dest/myapp；它是普通文件，或者路径尚不存在时，才会按文件目标理解。目录软链接也属于需要特别注意的情况，因为它的最终指向仍可能让目标被当作目录。

普通 install：目录会吸收源文件名

普通两参数形式适合“把这个文件安装到某个目录”的表达。例如目标目录为 /usr/local/bin，源文件名为 myapp，下面的命令目标就是 /usr/local/bin/myapp：

# 最后一个参数是目录，install 会在目录后追加源文件名
install -m 0755 ./build/myapp /usr/local/bin

# 等价的目标路径是：/usr/local/bin/myapp
# -m 0755 只负责安装后的权限，不改变目录目标的解释方式

这也是普通写法最容易产生误会的地方：命令行看起来只有一个“目标名”，但目标是目录时，最终文件名来自源文件。若脚本原本想把程序固定写成 /usr/local/bin/app，而这条路径后来被创建成目录，普通写法就可能把文件放到 /usr/local/bin/app/myapp，结果与脚本作者的意图不同。

install -T：把最后一个参数固定成文件目标

-T 的长选项是 --no-target-directory。它的作用是“不把最后一个操作数特殊当作目录”，因此适合配置文件、固定名称的二进制文件和需要明确替换位置的部署脚本：

# 明确把 app 当作文件目标，而不是目录容器
install -T -m 0755 ./build/myapp /usr/local/bin/app

# 目标语义固定为 /usr/local/bin/app
# 如果该路径是目录，命令应失败，而不是自动变成 app/myapp

这里的“固定”主要是路径解释固定，不等于无条件覆盖成功。权限不足、源文件不存在、目标类型不合适等原因仍然会让命令失败。正因为 -T 不替你猜目录，部署脚本可以更早暴露路径配置错误。

install -t：把目标目录写在选项里

当脚本一次安装多个文件，或输入来自循环、xargs 等批量来源时，-t 比“最后一个参数猜目录”更清楚：

# 显式指定目录，后面的每个源文件都使用自己的文件名
install -t /usr/local/bin -m 0755 \
    ./build/myapp ./build/helper

# 两个目标分别是 /usr/local/bin/myapp 和 /usr/local/bin/helper
# -t 与 -T 不能同时使用，脚本只选择一种目标语义

-t 还适合把目标目录和源文件列表分开构造，减少参数顺序变化带来的误读。若还需要确保目录层级存在，可以结合 -D 的目录创建语义，但要先确认当前脚本确实需要创建父目录，不要把“文件目标”和“目录创建”混成一个隐含动作。

覆盖前怎么留回滚路径

install 负责复制文件并设置属性，不会自动替你设计发布回滚。对固定文件目标，通常先用备份策略保留旧文件，再执行 -T；对目录目标，则把回滚对象定义为被替换的具体文件，而不是整个目录：

# 备份固定文件目标，再把新构建产物安装到固定路径
target="/usr/local/bin/app"
backup="${target}.bak"

if [ -f "$target" ]; then
    # 先保留旧版本，失败时可以恢复；不删除目录或未知类型
    install -m 0755 "$target" "$backup"
fi

# -T 保证新文件不会因为同名目录而改变落点
install -T -m 0755 ./build/myapp "$target"

# 回滚时只恢复固定文件，并保留失败原因供值班记录
if [ "$?" -ne 0 ] && [ -f "$backup" ]; then
    install -T -m 0755 "$backup" "$target"
    exit 1
fi

实际发布脚本还应在关键命令处使用更严格的错误处理，并把备份命名、保留时长和清理责任写清楚。示例的重点是目标语义：备份和恢复都使用 -T，这样回滚不会再次因为目标目录状态变化而落到意外位置。

值班时的快速选择表

最后的告警确认和复盘项

如果线上出现“部署成功但程序没有更新”，优先查看脚本记录的最终路径、目标在发布前后的文件类型，以及是否把固定文件目标误写成了目录目标。不要只看命令退出码，因为普通写法把文件放进目录时也可能是成功退出。

复盘时可以把下面三项加入发布清单：固定路径统一使用 -T；批量目录统一使用 -t；覆盖前保留可识别的备份并定义恢复命令。这样，install 的差异就从“记参数”变成了可检查的路径契约。

常见追问

install -T 和 install -D 是一回事吗？

不是。-T 约束最后操作数不要按目录特殊处理；-D 关注创建目标文件所需的父目录，然后复制到指定目标。两者解决的是不同维度的问题，是否组合要看脚本是否需要自动补齐目录层级。

目标目录是符号链接时应该用哪个参数？

先确认脚本想操作的是链接指向的目录，还是想把链接路径本身当成文件目标。前者使用目录语义，后者使用 -T 并在发布前明确检查；不要让链接状态变化决定生产文件的落点。

可以同时写 -T 和 -t 吗？

不可以。它们分别固定文件目标和目录目标，GNU Coreutils 文档明确说明两者不能组合。