如何通过uvx使用ansible-dev-tools的adt及全部可执行文件？

问题原因 #

uvx 需要指定包名而非可执行文件名来调用工具。你执行 uvx adt 时，uvx 会把 adt 当作包名查找，但实际包名是 ansible-dev-tools，因此报错提示找不到可执行文件。

解决方案 #

1. 调用 adt 命令

使用包名 ansible-dev-tools 来指定，命令格式如下：

uvx ansible-dev-tools adt

如果 adt 是该包的默认可执行文件，也可以直接省略命令名，简化为：

uvx ansible-dev-tools

2. 调用其他可执行文件

对于 ansible-dev-tools 提供的其他可执行文件（比如adt-test、adt-lint等），同样遵循「包名 + 命令名」的格式：

uvx ansible-dev-tools <other-executable-name>

补充说明 #

你通过 uv tool install ansible-dev-tools 安装后，adt 已经被链接到 ~/.local/bin，只要该目录在你的系统 PATH 中，直接运行 adt 即可使用，无需通过 uvx。uvx 更适合临时运行某个包的工具，或者不想依赖本地已安装版本时使用。

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