Nushell
安装 Nu !
快速开始
  • Nushell 之书
  • 命令参考列表
  • 实战指南
  • 语言参考指南
  • 贡献指南
博客
  • English
  • 中文
  • Deutsch
  • Français
  • Español
  • 日本語
  • Português do Brasil
  • Русский язык
  • 한국어
GitHub
安装 Nu !
快速开始
  • Nushell 之书
  • 命令参考列表
  • 实战指南
  • 语言参考指南
  • 贡献指南
博客
  • English
  • 中文
  • Deutsch
  • Français
  • Español
  • 日本語
  • Português do Brasil
  • Русский язык
  • 한국어
GitHub
  • 简介
  • 安装
    • 默认 Shell
  • 快速入门
    • 快速入门
    • 在系统中四处移动
    • 用 Nu 的方式思考
    • Nushell 速查表
  • Nu 基础篇
    • 数据类型
    • 加载数据
    • 管道
    • 处理字符串
    • 处理列表
    • 处理记录
    • 处理表格
    • 导航和访问结构化数据
    • 特殊变量
  • Nushell 编程
    • 自定义命令
    • 别名
    • 运算符
    • 变量
    • 控制流
    • 脚本
    • 模块
      • 使用模块
      • 创建模块
    • 覆层
    • 排序
    • 测试你的 Nushell 代码
    • 脚本调试
    • 最佳实践
  • Nu 作为 Shell 使用
    • 配置
    • 环境
    • 标准输出、标准错误和退出码
    • 运行系统(外部)命令
    • 如何配置第三方提示
    • 目录栈
    • Reedline,Nu 的行编辑器
    • 自定义补全
    • 外部命令
    • Nu 的配色和主题
    • 钩子
    • 后台任务
  • 迁移到 Nu
    • 从 Bash 到 Nu
    • 从 CMD.EXE 到 Nu
    • 从 PowerShell 到 Nu
    • 从其他 Shell 或 DSL 到 Nu
    • 从命令式语言到 Nu
    • 从函数式语言到 Nu
    • Nushell 运算符对照
  • 设计说明
    • Nushell代码执行原理
  • (不怎么)高级篇
    • 标准库
    • Dataframes
    • 元数据
    • 创建你自己的错误
    • 并行
    • 插件
    • explore
    • 使用 tui 构建终端用户界面
    • MCP 服务器

explore

explore 是一个表格分页器,类似于 less,但面向结构化数据。把任意值用管道传给它,就可以滚动浏览、深入查看嵌套的记录和表格、搜索,并对你正在查看的内容运行 Nushell 命令。

签名

> explore --head <bool> --index --tail --peek

参数

  • --head <bool>:显示或隐藏列标题(默认 true)
  • --index, -i:查看列表时显示行索引
  • --tail, -t:视口初始滚动到底部
  • --peek, -p:退出时输出光标所在单元格的值

快速开始

ls | explore -i

explore-ls-png

还有几种启动方式:

# Explore the system host information record
sys host | explore

# Explore the output of ls without column names
ls | explore --head false

# Start at the end of a long list
help commands | explore --tail

# Explore a JSON file, then save the part you were looking at when you quit
open file.json | explore --peek | to json | save part.json

移动浏览

按键动作
方向键,或 h j k l移动光标
Ctrl+p / Ctrl+n向上 / 向下移动(Emacs 风格)
PageUp / PageDown、Ctrl+b / Ctrl+f、Alt+v / Ctrl+v向上 / 向下翻页
Home / End,或 g / G跳到第一行 / 最后一行
Enter 或 i进入光标模式;在光标模式下深入查看所选单元格
Esc 或 q退出光标模式;否则返回上一层,在顶层则退出
t转置(行列互换),在视图模式下
e展开(显示所有嵌套数据)

explore 以 视图 模式启动(状态栏显示 VIEW),此时方向键滚动表格。按 Enter(或 i)切换到 光标 模式(状态栏显示 EDIT),此时方向键让光标在单元格之间移动。在存放记录或列表的单元格上再按一次 Enter,会在新视图中打开它,这样你就能逐层深入嵌套数据。按 Esc 退出光标模式,再按一次则返回上一层。

搜索

按 / 向前搜索,或按 ? 向后搜索。结果会随着你的输入高亮显示。然后用 n 和 N 在匹配项之间移动。

命令

explore 带有几个内置命令。按 : 然后输入命令名称:

命令动作
:help显示帮助页面
:try在当前数据上打开交互式 REPL
:nu <cmd>在当前数据上运行 Nushell 命令
:q退出 explore

配置

explore 的颜色在 $env.config.explore 中配置。每个取值都与 color_config 的形式相同:颜色名、#RRGGBB 十六进制代码,或 {fg, bg, attr} 记录。例如:

$env.config.explore = {
    selected_cell: { bg: light_blue }
    highlight: { fg: black, bg: yellow }
    title_bar_text: { fg: white }
    title_bar_background: { bg: blue }
    status: {
        success: { fg: black, bg: green }
        error: { fg: white, bg: red }
    }
    try: { reactive: false }
}

支持的键有 selected_cell、highlight、status_bar_text、status_bar_background、command_bar_text、command_bar_background、title_bar_text、title_bar_background、status(包含 info、success、warn 和 error 条目),以及 try.reactive。当 try.reactive 为 true 时,:try 会在你输入时重新运行命令,而不只是在你按 Enter 时才运行。

运行 config nu --doc 可以查看每个键的文档和默认值。

示例

查看值

$nu | explore --peek

explore-peek-gif

:try 命令

有一个交互式环境,你可以用 nu 在其中浏览数据。

explore-try-gif

用 $nu 保留所选的值

记住你可以将它与 --peek 结合使用。

explore-try-nu-gif

浏览你的配置

explore config 会把你当前的 $env.config 作为一棵树打开,并带有一个编辑窗格。用 Tab 在树和编辑器之间切换,用方向键移动以及展开或折叠节点,用 Enter 开始编辑某个值。按 Ctrl+S 应用编辑。用 q 退出时,你的改动会应用到当前会话;Ctrl+C 则不保存退出。

# Browse and edit the running configuration
explore config

# Explore any JSON data as a tree
open --raw data.json | explore config

# Print the tree without starting the TUI
open --raw data.json | explore config --tree

构建正则表达式

explore regex 会打开一个交互式编辑器,用于在示例文本上构建和测试正则表达式。按 Ctrl+Q 退出,你所构建的表达式会被返回:

let pattern = open notes.txt | explore regex
open notes.txt | lines | where $it =~ $pattern

构建你自己的界面

explore 是一个现成的查看器。要构建你自己的交互式界面,例如选择器、表单或仪表板,请参阅用 tui 构建终端用户界面。

在GitHub上编辑此页面
Contributors: voyage200🍬, Jianjun Wang, passionworkeer
Prev
插件
Next
使用 tui 构建终端用户界面