Facebook PathPicker 命令行工具使用指南

工具概述

Facebook PathPicker（简称fpp）是一个强大的命令行工具，它能够从bash命令的输出中智能识别文件路径，并提供一个交互式界面让用户选择需要操作的文件。这个工具特别适合处理git、grep、find等命令的输出结果，极大地提升了命令行工作效率。

基本使用方法

输入管道

fpp的核心使用方式是通过管道接收其他命令的输出：

git status | fpp
git show | fpp
git diff HEAD master | fpp
grep -r "Banana" . | fpp
find . -iname "*.js" | fpp

工具会自动识别输出中的文件路径，并将它们展示在交互界面中。

交互界面操作

文件选择

进入fpp界面后，可以使用以下命令进行文件选择：

• f：切换当前文件的选中状态
• F：切换当前文件选中状态并向下移动一行
• A：切换所有文件的选中状态
• ↓或j：向下移动一行
• ↑或k：向上移动一行
• 空格：向下翻页
• b：向上翻页
• x：快速选择模式
• d：查看文件描述

执行操作

选择文件后，可以执行两种主要操作：

1. 直接打开：按Enter键，所有选中的文件会在默认编辑器中打开
2. 命令模式：按c键进入命令模式，可以对选中的文件执行自定义命令

命令模式详解

命令模式是fpp最强大的功能之一，它允许用户对选中的文件执行任意命令。

基本用法

在命令模式下，只需输入命令前缀，fpp会自动将选中的文件追加到命令后面：

git add  # 会变成 git add file1 file2
rm -rf  # 会变成 rm -rf file1 file2

高级用法

如果需要将文件插入到命令中间，可以使用$F占位符：

scp $F dev:~/backup  # 变成 scp file1 file2 dev:~/backup
mv $F ../over/here  # 变成 mv file1 file2 ../over/here

配置选项

fpp提供了多种配置方式，满足不同用户需求：

编辑器设置

通过环境变量控制使用的编辑器：

• FPP_EDITOR：指定首选编辑器
• VISUAL/EDITOR：备选编辑器变量
• 默认使用vim

禁用vim分屏功能：

export FPP_DISABLE_SPLIT=1

目录设置

fpp会保存状态文件，默认位置是$XDG_CACHE_HOME/fpp，可以通过FPP_DIR变量修改。

颜色支持

fpp支持彩色输出，但需要确保输入命令启用了颜色选项：

• git：git config --global color.ui always
• ls：使用-G选项（Mac上还需设置CLICOLOR_FORCE）

命令行参数

fpp支持多种命令行参数，可以通过fpp --help查看完整列表，常用参数包括：

• --help：显示帮助信息
• --version：显示版本信息
• --keep-open：执行命令后保持界面打开

使用建议

对于初次使用者，建议从简单的git命令开始体验：

git status | fpp

熟悉基本操作后，可以尝试更复杂的场景，如批量重命名、跨服务器文件传输等。fpp的强大之处在于它能将命令行输出快速转换为可操作的文件列表，大大简化了日常开发中的文件操作流程。