MatrixSpy

中文 | English

一个强大的 VS Code 扩展，用于浏览、可视化和导出 MATLAB .mat 文件。支持所有 MAT 版本（v4–v7.3），交互式张量可视化与缩放控制，以及导出为 CSV/JSON/NumPy/PNG 格式。

💡 我是个人开发者，纯靠兴趣维护这个项目。如果 MatrixSpy 对你有帮助，希望能动动发财的小手点个 ⭐ Star，这是对我最大的鼓励，谢谢！

功能特性

• 全版本 MAT 文件支持：v4、v5、v6、v7、v7.3（HDF5）
• 交互式张量可视化：
  • 1D 数组：带迷你折线图的网格视图
  • 2D 矩阵：热图或表格视图
  • 3D/4D+ 张量：切片查看器与缩放控制
  • 复数：幅值 / 相位 / 实部 / 虚部
• 9 种配色方案：Grayscale、Viridis、Inferno、Plasma、Hot、Jet、Turbo、Coolwarm、RdBu（还支持通过设置自定义配色）
• 键盘快捷键：方向键切换切片、+/- 缩放、T/I 切换视图、C 切换配色
• 图像增强：Window/Level 对比度调节、旋转、水平/垂直翻转
• 变量搜索与过滤：侧边栏搜索框，支持 type: 前缀按类型过滤
• 状态栏：显示文件名、变量数量、当前变量的维度/数据类型/内存占用
• 缩放控制：+/- 按钮、1:1 重置、自适应大小
• 缩放持久化：切换切片/轴/视图模式时保持缩放级别
• 树形视图：变量导航，支持展开结构体
• 懒加载：大型 3D 张量和 HDF5 数据集按需加载
• 数据导出：CSV、JSON、NumPy NPY、PNG 图像、HDF5
• 安装向导：自动检测依赖并引导安装

前置要求

Python 3.8+ 及以下依赖：

pip install scipy numpy h5py mat73

扩展会在首次启动时检查依赖并引导你完成安装。

使用方法

打开 MAT 文件

1. 在资源管理器中双击 .mat 文件
2. 右键点击 .mat 文件 → "Open MAT File"
3. 命令面板（Cmd+Shift+P）→ "MatrixSpy: Open MAT File"

导航

• 侧边栏：浏览所有变量，展开结构体，点击查看
• 搜索框：按名称或类型过滤变量（如 type:struct）
• 树形项：展开/折叠嵌套结构

可视化

图像模式控制

在 Image 模式下查看张量时：

• + / -：放大/缩小（每次 1.5 倍）
• 1:1：重置为自适应大小
• Window/Level：通过滑块调节对比度范围
• 旋转：↺ / ↻ 按钮（90° 步进）
• 翻转：⇄ 水平 / ⇅ 垂直
• 缩放持久化：切换切片时保持缩放级别
• 自适应大小：小张量自动放大，大张量适应容器

键盘快捷键

导出

• 命令面板 → "MatrixSpy: Export to CSV" / "Export to JSON" / "Export to NumPy" / "Export to PNG" / "Export to HDF5"

配置

{
  "matrixspy.pythonPath": "python3",
  "matrixspy.maxFileSizeMB": 100
}

更新日志

完整版本历史请查看 CHANGELOG.md。

v1.5.5 亮点 (2026-06-22)

• 安全加固: webview CSP nonce、shell 参数注入防护
• 键绑定修复: 从 Cmd/Ctrl+Shift+E/D/R/M 改为 Cmd/Ctrl+Alt+E/D/R/M，避免 VS Code 冲突
• 新 maxFileSizeMB 设置: 范围 1–4096 MB（替代已弃用的 maxDataSize）
• webview 导出按钮: 工具栏 📤 按钮快速导出
• Setup Wizard 自动测试: 安装依赖后自动测试环境
• 多标签页修复: 每个打开的 MAT 文件现在有独立的消息监听器

v1.5.0 亮点 (2026-06-03)

• MAT 文件差异对比：对比两个 .mat 文件的变量差异
• 国际化 (i18n)：支持中文界面

v1.4.0 亮点 (2026-06-02)

• 1D 折线图视图：1D 数组可视化折线图
• Table 虚拟滚动：大数据表格流畅滚动
• 面包屑导航：结构体字段路径导航

v1.3.0 亮点 (2026-05-24)

• 9 种配色方案：新增 Hot、Jet、Turbo、Coolwarm、RdBu
• 键盘快捷键：常用操作快捷键
• 状态栏：显示当前文件和变量信息
• 变量搜索与过滤：侧边栏搜索
• 图像增强：Window/Level、旋转、翻转
• 新导出格式：NumPy NPY 和 PNG 图像

v1.2.0 亮点 (2026-05-15)

• 持久化 Python 守护进程：切片加载速度提升约 25 倍
• 安全：CSP nonce、Python 注入防护
• 增强统计信息：百分位数、NaN/Inf、稀疏度、内存占用

许可证

MIT License

联系方式

功能请求或 Bug 报告：GitHub Issues

祝你查看 MAT 文件愉快！