Monaco Editor 不提供直接的 setValueInRange 方法，但可通过 executeEdits API 安全、原子化地批量修改任意文本范围，适用于实现数字调节器（scrubber）、代码重构、实时替换等场景。
monaco editor 不提供直接的 `setvalueinrange` 方法，但可通过 `executeedits` api 安全、原子化地批量修改任意文本范围，适用于实现数字调节器（scrubber）、代码重构、实时替换等场景。
在 Monaco Editor 中，对编辑器内容进行程序化编辑（如替换某一段文本）不能通过简单赋值或模型方法完成，因为编辑器的文本模型是只读快照式的（immutable snapshot model）。正确的做法是调用编辑器实例的 executeEdits 方法，它接受一个“编辑操作数组”，每个操作明确指定作用范围（range）和目标文本（text），并以事务方式执行——即全部成功或全部回滚，确保编辑一致性。
✅ 正确用法：editor.executeEdits()
// 示例：将第1行第1列到第1行第1列（即光标位置）替换为新字符串
const newCode = "42";
editor.executeEdits('number-scrubber', [
{
range: new monaco.Range(1, 1, 1, 1), // 起始行、列，结束行、列（含左不含右）
text: newCode,
}
]);⚠️ 注意：
- range 是 1-indexed（行号与列号均从 1 开始），且 endColumn 是不包含的（即 [startLine, startColumn, endLine, endColumn) 区间）；
- 若需替换一个实际有长度的范围（如变量名 "count"），请精确计算其列位置，例如：new monaco.Range(5, 10, 5, 15) 表示第5行第10–14列（共5字符）；
- 第一个参数 'number-scrubber' 是source 字符串，用于标识编辑来源（如撤销栈归类、调试日志），可自定义，但建议语义化；
- executeEdits 返回 IIdentifiedSingleEditOperation[]，包含实际应用后的操作详情，可用于后续校验或链式处理。
? 批量编辑与空范围处理
你也可以一次执行多个编辑操作（如同时更新多个数字）：
editor.executeEdits('number-scrubber', [
{ range: new monaco.Range(3, 8, 3, 12), text: '100' }, // 替换第3行第8–11列
{ range: new monaco.Range(7, 15, 7, 18), text: '3.14' }, // 替换第7行第15–17列
]);对于“空范围”（起止位置相同，如 Range(1,1,1,1)），text 将被插入而非替换；若 text 为空字符串（""），则等效于删除光标处零宽内容（即无实际变更）。
❌ 常见误区澄清
- IEditOperationBuilder 已废弃且未暴露为公共 API（v0.41.0+ 中不可访问），无需尝试构造或查找；
- editor.getModel().setValue() 不存在 —— 模型本身不可直接赋值，必须通过 executeEdits；
- 不要手动修改 model.getValue() 返回的字符串再设回，这会破坏编辑器内部状态（如视图映射、undo 栈、token 缓存）。
✅ 最佳实践建议
- 使用 editor.onDidChangeModelContent 监听变更，避免与用户输入冲突；
- 对数值 scrubber 场景，推荐先用 getValueInRange 获取原始值 → 解析 → 计算新值 → 构造精准 Range → 调用 executeEdits；
- 如需高亮编辑区域，可在 executeEdits 后调用 editor.setSelection(newRange) 并滚动至可视区域（editor.revealRangeInCenterIfOutsideViewport(newRange)）。
通过 executeEdits，你不仅能安全编辑 Range，还能无缝融入 Monaco 的撤销/重做、语法高亮更新、语言服务响应等完整编辑生命周期。
