如何通过Python脚本获取fish shell全部命令？解决调用报错问题

问题原因 #

fish的complete -C选项需要接收一个补全前缀参数：在交互式终端中，fish会自动填充当前输入的上下文前缀；但通过fish -c直接执行时，必须显式传递参数（哪怕是空字符串），否则会报错提示“-C选项需要参数”。

修正后的subprocess实现 #

方式1：使用参数列表（推荐，避免shell解析问题） #

直接通过subprocess的参数列表传递命令，无需依赖shell=True：

import subprocess

result = subprocess.run(
    ['fish', '-c', 'complete -C ""'],
    capture_output=True,
    text=True
)
# 获取所有补全命令列表
command_list = result.stdout.strip().split('\n')

方式2：使用shell=True（需注意引号转义） #

如果必须用shell=True，要确保空字符串参数的引号正确转义：

import subprocess

command = "fish -c 'complete -C \"\"'"
output = subprocess.run(command, shell=True, capture_output=True, text=True).stdout.strip()
command_list = output.split('\n')

非subprocess的替代方案 #

方案1：调用fish专用补全函数 #

fish内置了__fish_complete_command函数，专门用于补全命令名称，返回结果更简洁：

import subprocess

result = subprocess.run(
    ['fish', '-c', '__fish_complete_command ""'],
    capture_output=True,
    text=True
)
command_list = result.stdout.strip().split('\n')

方案2：解析fish补全配置文件 #

fish的补全规则存储在两个目录：

• 用户级：~/.config/fish/completions/
• 系统级：/usr/share/fish/completions/

你可以遍历这些目录下的.fish文件，解析其中的补全定义（比如complete -c <命令名>格式的行）。但这种方式需要自己处理复杂的补全逻辑（如动态生成的补全），可靠性不如直接调用fish本身。

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