中文指南

在 VS Code 中查看 .npy 和 .npz NumPy 文件

安装免费的 Tensor Viewer (NPZ Viewer & NPY Viewer)，点击 .npy 或 .npz 文件。每个数组都会列出名称、dtype 和 shape，点击后显示 min、max、mean、std、NaN 数量、图表、直方图和具体数值，不需要 Python。查看、图像显示、Values 表格以及 Save as .npy 或 CSV 都免费。Zovo Pro（一次性 19 美元）增加两个工具，Compare two checkpoints 和 Scan all tensors，每个可以免费试用 3 次。

免费，MIT 许可证。扩展 ID zovo.tensor-viewer，版本 0.6.5。

其他语言版本 English · Deutsch · Español · Français · Italiano · 日本語 · Polski · Português (Brasil)

在 VS Code 中的步骤

1. 从 Marketplace 安装 Tensor Viewer，或者按 Ctrl+P（macOS 上按 Cmd+P）后运行 ext install zovo.tensor-viewer。
2. 在 Explorer 中点击 .npy 或 .npz 文件。表格列出每个数组的名称、类型、shape、参数量和大小。
3. 点击一个数组。右侧面板显示 min、max、mean、std 以及 NaN、Inf 和零值的数量，然后是二维数组的热力图或一维数组的折线图，以及直方图。
4. 在 Values 表格中查看数值，每次 32 行。三维及以上的数组可以在 Slice 输入框中输入切片，例如 [5, :, :]。
5. 如果数组的形状像图像，例如 (H, W, 3) 或 (N, 3, H, W)，Image 区域会把它画出来，可以在那里选择 Layout、Frame 和 Range。浮点矩阵则显示一个 “Show as image” 按钮。
6. 点击 “Save as .npy...” 或 “Save as CSV...”，把数组或当前切片写入新文件。

哪些免费，Zovo Pro 增加什么

所有格式、统计值、热力图、折线图、直方图、图像显示、Values 表格、切片、原始数组以及 Save as .npy 或 CSV 都免费。不需要 Python，查看器也不发网络请求。

Scan all tensors 读取文件中每个数组的每一个值，而不是抽样，并标出 NaN、Inf、全零和常量数组，以及大于等于 10,000 的浮点值。它在一份报告里给出每个数组精确的 min、max、mean、std 和 L2 范数，报告可以筛选，也可以保存为 CSV、Markdown 或 JSON。在很大的 .npz 里找出有问题的数组，不用一个个点开看。

使用 Scan all tensors（Zovo Pro）

7. 打开文件，点击查看器顶部的 “Scan all tensors” 按钮，或者在 Explorer 中右键点击文件，选择 “Zovo Pro: Scan Tensors for NaN, Inf and Zeros”。
8. 也可以从 Command Palette 运行 “NumPy Viewer Pro: Scan All Tensors for NaN, Inf and Zeros”，然后选择文件。
9. 通知会显示进度，运行时间长时可以按 Cancel 停止。在报告中使用 “Only tensors to check” 筛选，然后把报告保存为 CSV、Markdown 或 JSON。

Scan all tensors 在你的电脑上可以免费用 3 次，之后才需要许可证。没有弹窗，也没有倒计时。

Zovo Pro 一次性付费 19 美元，不是订阅。许可证会启用所有 Zovo 扩展里的 Pro 工具，不只是 Tensor Viewer。用银行卡（Stripe）付款后，许可证密钥会显示在下一个页面上。在 VS Code 的 Command Palette 里运行 “Zovo Pro: Enter Zovo Pro license key”，粘贴密钥即可。密钥在你的电脑上本地校验，不联网。通过 GitHub Sponsors 付款时，选择 "$19 one time" 档位，然后运行 “Zovo Pro: I already paid: unlock with GitHub Sponsors”。

5 人团队一次性付费 59 美元（用银行卡付款）。 全部规则和 Pro 工具见 Zovo Pro 页面（英文）。

在 Cursor、Windsurf 或 VSCodium 中的步骤

1. 按 Ctrl+Shift+X（macOS 上按 Cmd+Shift+X）打开 Extensions 视图。
2. 搜索 zovo.tensor-viewer，点击 Install。Cursor、Windsurf 和 VSCodium 从 Open VSX 安装扩展，这个扩展在那里的名称是 zovo/tensor-viewer。
3. 如果编辑器没有扩展商店，就在 Open VSX 页面下载 .vsix 文件，然后运行 “Extensions: Install from VSIX...”。
4. 之后的用法和 VS Code 里一样。

Tensor Viewer 能做什么

• .npy 文件，支持 v1、v2、v3 文件头，C 和 Fortran 顺序，大端和小端字节序。
• .npz 压缩包，支持未压缩（stored）和 deflate 压缩的条目，包括 zip64。
• bool、int8 到 int64、uint8 到 uint64、float16、float32、float64 和复数（统计值按模计算）。
• 形状像图像的数组、图像堆栈和批次会画成图片，一次显示一帧。
• 同一个扩展还能打开 .safetensors、.gguf 以及 PyTorch 的 .pt、.pth 和 .ckpt 文件。

它做不到的事

• pickle 序列化的对象数组只会列出并被拒绝加载，绝不会执行。文本和结构化数组只列出，不计算统计值。
• 超过 2,000,000 个值的数组在计算统计值和绘图时会抽样（设置项 tensorViewer.sampleValues），面板会注明统计值来自抽样。
• 压缩的 .npz 条目只从头读取，前 64 MB 之后的值不会显示，超过 512 MB 的条目无法保存。
• 图片的长边最多绘制 512 像素。双通道数组和 Fortran 顺序的数组没有图片视图。
• CSV 导出最多 2,000 万个值。大于 2^53 的 int64 值在表格和 CSV 中会丢失最后几位。

常见问题

更多信息

英文版指南里有更多细节和其他方案。每个功能和设置都写在 Tensor Viewer 的页面上（英文）。

内容已于 2026 年 11 月 12 日对照 Marketplace 当前版本核实。