简体中文 | English
一个 Eclipse 调试插件:把调试变量或监视表达式显示成表格。这样 List<Employee>、Map、double[][] 这类数据可以靠滚动和排序直接看,而不必在「变量」视图里一层层展开节点。
- 任何变量都能变表格。 在「变量」视图、Inspect 弹窗或监视表达式里选中变量,执行 Show as Table(
Ctrl+Alt+V)。数组、Map、集合、以及自定义对象的List都支持。 - 对象列表无需配置。 列就是元素类型的实例字段(含父类,排除静态字段)。无参 getter 可以作为列,但需要在偏好页显式打开——每个 getter 单元格都是一次对目标 VM 的调用。
- 列选择器。 表格窗口里的 Columns... 会按类型写一条规则(
com.demo.Employee#id,name,salary),可以精确控制显示哪些成员、按什么顺序。 - 分页读取,不整体复制。 首屏 100 × 100 个单元格,之后滚动条到达末端才读下一页。10000 × 10000 的矩阵,代价只跟屏幕上的内容有关。
- 冻结行号。 行号是一个贴在左侧的独立表格——SWT 本身不支持冻结列。
- PyCharm 风格着色。 数值列按自身取值范围做红/白/蓝热力图,其他列可选斑马纹。
- 单元格编辑(默认关闭)。 Enable editing 默认不勾,避免误双击改了程序状态。
null行显示为灰色且不可编辑。 - Excel 风格复制。 拖出一个矩形后
Ctrl+C,按制表符分隔复制;没有选中时复制整张已加载的表。 - UI 线程不做任何读取。 每次读取都是
Job,并按调试目标串行化,目标慢的时候不会把 Eclipse 卡住。
读取一个单元格可能意味着在目标 VM 里执行代码,这是唯一能让调试会话挂死的操作。插件把它当作一等公民处理:
- 方法调用可以整体关闭;
- 一份固定的阻塞/终止方法清单(
wait、notify、join、sleep、lock、close、shutdown、exit等)永不调用,且不可关闭; - 支持用户自定义黑名单;
- 每次调用前,守卫会检查该对象的锁是否被另一个挂起线程持有。JDI 用
INVOKE_SINGLE_THREADED求值,这种调用永远不会返回——于是跳过并报告。
被跳过的调用只会影响某个值显示成什么样,绝不会有静默行为:表格下方的警告条会写出来。
- Eclipse 2023-06 或更新(开发与验证基于 2025-06),Java 17 及以上
- 必须带 JDT:这是一个 JDT 调试插件,没有 JDT 无法工作
从更新站点安装(推荐):
Help > Install New Software… > Add,地址填
https://qimu55kai.github.io/com.value.table/,选中 ValueTable,装完重启。
安装对话框底部那个 Contact all update sites during install to find required software 请取消勾选。本插件只用平台上已有的 JDT / UI bundle,不需要去别处找依赖;勾着它,p2 可能顺带把平台侧上百个 bundle 换成别的发布版本,装完 eclemma、产品图标之类会一起坏掉。
为什么「只装一个插件」会连着升级上百个 bundle
那个勾选框在 p2 里的默认值是 开(Policy.contactAllSites = true,AvailableIUsPage 在没有任何记忆值时就取这个默认)。勾着的含义是:解析安装计划时,把所有已启用的更新站点都算进去,并为计划里的每个 IU 挑「能满足约束的最新版本」。而 EPP 包默认启用的站点里有几个是复合站点,内容会自己往前跑:
| 站点 | 行为 |
|---|---|
download.eclipse.org/releases/latest |
每季度自动指向新的发布列车 |
download.eclipse.org/technology/epp/packages/latest |
同上,EPP 包本体 |
download.eclipse.org/webtools/repository/latest |
WTP 最新构建 |
download.eclipse.org/technology/m2e/releases/latest |
m2e 最新版 |
download.eclipse.org/eclipse/updates/4.36 |
当前平台的 SR 更新 |
于是「装一个只在平台上已有 bundle 上有依赖的插件」,也可能把 EMF、jetty、asm、icu 一并换到下一年的版本,重启时几百个文件要重写,看着就像卡死。本插件自己的站点只有 3 个 IU(插件 + feature + category),物理上提供不了这些 bundle。
避免办法,按性价比排序:
- 装之前取消勾选上面那个 Contact all update sites…。
- Preferences > Install/Update > Available Software Sites:把带
latest的站点取消勾选,只留与 IDE 版本对应的那条(例如releases/2025-06),再加自己的站点。这一条是长效的。 - Preferences > Install/Update > Automatic Updates:取消 Automatically find new updates and notify me,避免后台自己排计划。
- 自己的插件最稳的是离线装(dropins,或把
releng/com.value.table.site/target/repository当本地站点),完全不碰 p2 的仓库解析。
(不推荐在 feature/manifest 里给平台 bundle 加死上限来「防升级」:那样只是把静默升级换成安装直接失败。)
放进 dropins:
- 把
com.value.table_1.0.0.jar放进<eclipse>/dropins/。 - 完全重启 Eclipse。(在 Eclipse 运行中替换 jar 会让那个实例出错,直到重启为止——窗口右下角显示当前 jar 的构建时间,是判断「现在跑的是哪个 jar」最快的方式。)
也可以把本工程当作插件工程导入 Eclipse,用 Export > Deployable plug-ins and fragments 导出。
| 位置 | 操作 |
|---|---|
| 「变量」视图,右键 | Show as Table |
| 「变量」视图,工具栏 | ValueTable 按钮 |
| 窗口任意位置 | Ctrl+Alt+V |
| 「表达式」视图,双击一行 | 打开该值的表格 |
表格窗口,Ctrl+C |
复制选中的矩形区域为 TSV |
| 表格窗口,双击单元格 | 编辑(需勾选 Enable editing) |
Window > Preferences > Java > Debug > ValueTable
- Rules ——
class & arrayGetter & rowName & colName规则表。只有既不是数组、也不是Iterable/Iterator的类型才需要;页面里的 Help 说明了语法,包括用[m1,m2()]表示「一行对应这几个成员」,这正是让Map读成两列的办法。 - Columns per type —— 列选择器写下的那些行。故意保留成可编辑文本,方便在工作区之间复制。
- Calls into the debug target —— 方法调用开关、getter 列、锁守卫、黑名单、超时、行数上限。
- Language —— 跟随系统 / 中文 / English,启动时生效。
更新站点 / 发布产物(Tycho,需要 JDK 17+,Maven 由 wrapper 提供):
./mvnw -f releng/pom.xml clean package产物在 releng/com.value.table.site/target/repository/,就是一个 p2 仓库:content.jar、artifacts.jar、features/、plugins/。把它放到任意 HTTPS 静态目录下,就可以作为更新站点使用。打 v* tag 会由 GitHub Actions 自动构建并发布到 gh-pages,细节见 docs/marketplace.md。
单个 jar(放进 dropins/ 用):在 Eclipse 里 Project > Export > Deployable plug-ins and fragments 导出,或使用开发工作区里的 _build/build.sh(编译、写入构建时间、打包、自动安装,不随本仓库发布)。
src/com/value/table/
model/ 调试模型访问、规则、分页 —— 不含任何控件
show/ 窗口与对话框 —— 不在 UI 线程碰 JDI
preferences/ handlers/ util/
messages.properties 英文文案(基础 bundle)
messages_zh_CN.properties 中文文案
plugin.properties 平台从 plugin.xml 读取的文案 —— 仅英文
help.txt / help_zh_CN.txt 规则语法说明,一种语言一个文件
icons/ META-INF/ plugin.xml build.properties
pom.xml 插件工程本体(Tycho 从这里读 MANIFEST)
releng/ feature、更新站点、发布工程
docs/marketplace.md 上架 Eclipse Marketplace 的流程与文案
.github/workflows/ 打 tag 自动构建并发布更新站点
- 复制
messages.properties为messages_<locale>.properties并翻译值,键名必须完全一致(离线测试会比较键集合)。 - 复制
help.txt为help_<locale>.txt。 - 如果新语言需要特殊回退处理,在
Messages#systemLocale或偏好页里补上(中文就需要:所有zh_*都映射到zh_CN,避免中国香港、中国澳门、中国台湾回退成英文)。
plugin.properties 是故意不翻译的。它由扩展注册表读取,而注册表按平台级 -nl 语言选择译本——既不是本插件偏好页里选的语言,也无法在不重启 IDE 的情况下改变。翻译它会出现「英文表格窗口配中文右键菜单」或反过来的割裂,所以入口保持英文、只有窗口跟随偏好。该文件必须保持 ISO-8859-1:Properties.load 读的是字节,不是 UTF-8。
- JDI 调用没有超时、也无法取消。锁守卫能预测常见的死锁,但其他原因造成的阻塞仍会卡住它自己的那个 job——只影响那一张表,不影响 Eclipse。
- 拖动选区越过最后一行时不会继续加载。
List<Animal>里装Dog对象时只显示 Animal 的列;如果加 Dog 的列,在 Cat 行上必然是空的。
Eclipse Public License 2.0 —— 见 LICENSE。
