GoJS 与 Vue 3 集成时，若将 Diagram 实例声明为响应式数据（如放入 data() 或使用 ref/reactive），会导致绑定失效、视图不刷新；正确做法是将其作为非响应式实例属性（this.myDiagram = ...）直接挂载，避免 Vue 的代理劫持干扰 GoJS 内部状态同步。
gojs 与 vue 3 集成时，若将 diagram 实例声明为响应式数据（如放入 `data()` 或使用 `ref/reactive`），会导致绑定失效、视图不刷新；正确做法是将其作为非响应式实例属性（`this.mydiagram = ...`）直接挂载，避免 vue 的代理劫持干扰 gojs 内部状态同步。
在 Vue 3（尤其是 <script setup></script> 或 Options API）中使用 GoJS 时，一个常见却极易被忽视的问题是：将 go.Diagram 实例误置于 Vue 的响应式系统中。Vue 3 的 Proxy 机制会深度拦截所有嵌套属性访问，而 GoJS 的 Diagram、Node、Model 等对象内部依赖原始属性访问、事件监听和脏检查机制。一旦这些对象被 reactive() 包裹或作为 data() 返回值声明，其 data 属性（即 node.data）可能被 Vue 转换为 Proxy 对象，导致 GoJS 的 Binding 无法正确监听变化，进而引发“修改了 IsHighlighted 但图形不重绘”的现象——正如你所见：只有手动拖动节点才触发更新。
✅ 正确实践：始终将 GoJS 实例设为非响应式属性
在 Options API 中，切勿在 data() 中声明 diagram：
// ❌ 错误：diagram 进入响应式系统
data() {
return {
myDiagram: null // 不要这样！
}
}
✅ 正确方式（Options API）：
export default {
data() {
return {
// 其他响应式数据（如 searchQuery、nodesData 等）可放这里
searchQuery: ''
};
},
mounted() {
const myDiagram = $(go.Diagram, this.$refs.goJsDiagram, {
initialContentAlignment: go.Spot.Top,
"undoManager.isEnabled": false,
layout: $(CustomLayeredDigraphLayout, {
direction: 90,
layerSpacing: 50
})
});
myDiagram.nodeTemplate = $(go.Node, "Vertical",
$(go.Panel, "Auto",
$(go.Shape, "Rectangle", {
strokeWidth: 2,
fill: "white"
}, new go.Binding("stroke", "", (data) => this.getStroke(data)).ofObject()),
$(go.TextBlock, {
margin: new go.Margin(28, 22, 28, 22),
font: "bold 22px sans-serif",
stroke: "black"
}, new go.Binding("text", "Name"))
)
);
// ✅ 关键：直接挂载到 this，跳过 Vue 响应式系统
this.myDiagram = myDiagram;
},
methods: {
getStroke(node) {
if (node.data.IsHighlighted) return "yellow";
if (node.data.IsSelected) return "green";
return "black";
},
findNodeByName(name) {
const diagram = this.myDiagram;
if (!diagram) return false;
// ✅ 使用单个事务包裹全部操作，提升性能并确保原子性
diagram.startTransaction("highlight-search");
try {
diagram.nodes.each(node => {
const match = name && node.data.Name?.toLowerCase().includes(name.toLowerCase());
const shouldHighlight = match;
const isCurrentlyHighlighted = node.data.IsHighlighted === true;
if (shouldHighlight !== isCurrentlyHighlighted) {
diagram.model.setDataProperty(node.data, "IsHighlighted", shouldHighlight);
}
});
} finally {
diagram.commitTransaction("highlight-search"); // ✅ 必须 commit！
}
return diagram.nodes.any(n => n.data.IsHighlighted);
}
}
};
⚠️ 补充关键点：
-
事务必须配对使用：
startTransaction()后必须调用commitTransaction()（或rollbackTransaction()），否则模型变更不会触发重绘； -
避免重复 startTransaction：你原代码中多次调用
startTransaction('selected')且未 commit，会造成事务嵌套混乱； -
setDataProperty是唯一安全的修改方式：直接赋值node.data.IsHighlighted = true绕过 GoJS 模型通知机制，Binding 将完全失效； -
Vue 3 Composition API 用户注意：若使用
<script setup></script>，请用let myDiagram = null声明（顶层变量），并在onMounted中初始化并赋值，切勿用ref()或reactive()包裹myDiagram。
总结：GoJS 与 Vue 协同工作的核心原则是——职责分离：Vue 管理 UI 状态（搜索关键词、开关等），GoJS 独立管理图表逻辑与渲染；两者通过纯数据（如 Array/Object）桥接，而非共享实例引用。只要确保 Diagram 及其子对象（Node, Link, Model）始终游离于 Vue 响应式系统之外，所有 Binding、事务和自动更新都将如期工作。
