# IMPORTRANGE 函数文档
## 适用版本
⚠️ 仅适用于 **Synology Office 3.5 及以上版本**。
---
## 功能描述
从链接的 Synology 电子表格中导入指定范围的单元格数据，并保持同步更新。
---
## 语法格式
```spreadsheet
=IMPORTRANGE(spreadsheet_url, range_string)
参数说明
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
spreadsheet_url |
文本 | 是 | 目标电子表格的链接或标识符，支持以下格式： - Synology 电子表格 URL： https://example.com/oo/r/abc123abc123`<br>- **Synology 电子表格 ID**：abc123abc123<br>- **带专用 IP 的 URL**：https://10.11.21.131:5001/oo/r/abc123abc123`- 带 QuickConnect ID 的 URL：`https://example.quickconnect.to/d/s/abc123abc123/oqbDx28_gs9XuYfyp` |
range_string |
文本 | 是 | 指定要导入的工作表及单元格范围，格式为 "[SheetName]![CellRange]"- 若工作表名包含空格，需用单引号包裹： "'Sheet 1'!A1:B3" |
使用示例
示例 1：基础导入
Spreadsheet 1（当前表格）
A1: =IMPORTRANGE("abc123abc123", "Sheet1!A1:C3")
Spreadsheet 2（源表格）
| A | B | C |
|---|---|---|
| 86 | 17 | 38 |
| 42 | 6 | 77 |
| 12 | 8 | 66 |
结果
86 17 38
42 6 77
12 8 66
示例 2：带空格的工作表名（正确写法）
=IMPORTRANGE("abc123abc123", "'Sheet 1'!A1:B3")
结果
86 17
42 6
12 8
示例 3：带空格的工作表名（错误写法）
=IMPORTRANGE("abc123abc123", "Sheet 1!A1:B3")
结果
#REF!
（未使用单引号包裹含空格的工作表名）
注意事项
- 权限要求
- 首次引用新表格时需授权访问。
- 语法规则
- 工作表名含空格时必须使用单引号包裹，否则触发
#REF!错误。
- 工作表名含空格时必须使用单引号包裹，否则触发
- 数据同步
- 源数据更新后，目标表格需手动刷新或重新打开以同步数据。
- 常见错误
错误代码 原因 解决方案 #REF!工作表名含空格未加单引号 修改为 "'Sheet 1'!A1:B3"#N/A目标表格权限未授权 点击提示弹窗完成授权
最佳实践
✅ 命名规范：避免使用含空格的工作表名以减少语法错误。
✅ 范围优化：尽量缩小导入范围（如 A1:C10 而非整列）以提升性能。
✅ 错误排查：若数据未更新，检查源表格权限和网络连接。
```