低风险
省略工作表范围时可能把数据追加到非预期标签页
原文依据:5 处发现了什么
`--range` 不是必填项,默认值为 `A1`,文档说明这会选择第一个工作表。即使表格 ID 正确,多标签表格也可能因此写入错误标签页。
为什么需要注意
在执行命令且用户未明确指定范围时,单行或批量数据会被持久追加到第一个标签页,可能污染业务数据并需要手工清理。
该风险有源码支持:`--range` 可省略,默认值为 `A1`,文档明确说这代表第一个工作表。因此,在包含多个标签页的表格中,未指定范围时可能把数据追加到非预期标签页。技能同时要求执行写入前取得用户确认,这能降低风险,但不能消除默认目标不明确的问题。用户可要求每次写入前明确显示并确认表格 ID、标签页和范围。
| `--values` | — | — | Comma-separated values (simple strings) || `--json-values` | — | — | JSON array of rows, e.g. '[["a","b"],["c","d"]]' || `--range` | — | `A1` | Target range in A1 notation (e.g. 'Sheet2!A1') to select a specific tab |查看另外 4 个位置
- Use --values for simple single-row appends.- Use --json-values for bulk multi-row inserts.- Use --range to append to a specific sheet tab (default: A1, i.e. first sheet).| `--json-values` | — | — | JSON array of rows, e.g. '[["a","b"],["c","d"]]' || `--range` | — | `A1` | Target range in A1 notation (e.g. 'Sheet2!A1') to select a specific tab |- Use --json-values for bulk multi-row inserts.- Use --range to append to a specific sheet tab (default: A1, i.e. first sheet).> [!CAUTION]> This is a **write** command — confirm with the user before executing.