QField连接QGIS失败?工程文件怎么传?

QField连接QGIS老失败？别慌，90%是路径和同步没搞对

“我明明按教程导出了QField工程包，手机一打开就报错‘图层不可用’或‘项目加载失败’……”——这是我后台收到最多的求助之一。别急着卸载重装，Dr. Gis 在参与某市国土外业核查项目时，也踩过同样的坑。今天我就手把手带你理清：为什么连不上？文件到底该怎么传？

你以为的“导出工程”，其实漏了关键一步

很多新手以为在QGIS里点一下【Project】→【Export for QField】就万事大吉了。但QField不是魔法盒子，它需要完整的“数据包裹”——包括地图样式、坐标系、还有最重要的：所有源数据文件本身。

我在西藏做冰川变化调查时，曾因漏掉一个DEM.tif文件，导致整个外业组在海拔5000米的营地折腾了一下午。教训深刻：QField不认“链接”，只认“实物”。

类比一下：你把一份菜谱（QGIS工程）发给朋友，但他家没有酱油、葱姜蒜（源数据），那他照着菜谱也做不出菜来。QField同理——它必须拿到“食材包”才能开火。

三步走：从QGIS到手机的无痛传输方案

1. 第一步：正确打包工程
   在QGIS中，点击菜单栏【Project】→【Export for QField】。重点来了：勾选 Copy datasets（复制数据集）！这会强制把所有用到的shp、tif、gpkg等文件复制进导出文件夹。不勾这个，你就只是发了个“空壳菜谱”。
2. 第二步：选择靠谱的传输方式
   别再用微信/QQ传了！这些App会压缩或改名文件，导致路径断裂。推荐以下两种方式：
   • USB直连：手机插电脑，把整个导出文件夹拖进手机内部存储（如/Download/QField/）。
   • 云盘同步：用Google Drive、坚果云或Syncthing，确保文件夹结构原样同步到手机端。
3. 第三步：手机端路径要“对上号”
   在QField App里，点击左上角菜单 → 【Open Project】→ 找到你存放的文件夹，选中qfield.qgs或qfield_cloud.qgs打开。如果提示路径错误，说明你移动了文件夹位置——请保持原始导出结构不动。

高频报错诊断表：对号入座，秒解问题

进阶技巧：用QField Cloud实现自动同步（适合团队）

如果你经常多人协作或需要实时回传采集数据，强烈推荐绑定 QField Cloud。它就像给你的工程装了个“自动传送带”：

1. 在QGIS插件管理器安装并登录 QField Sync 插件。
2. 配置云项目，勾选“自动上传离线编辑”。
3. 手机端登录同一账号，项目会自动下载+上传变更。

这样你就再也不用手动拷贝文件了，特别适合灾害应急、管线巡检等高频更新场景。

总结：记住这个黄金法则

QField = 工程文件 + 所有源数据 + 原始路径结构。少一个环节，就会“连接失败”。按本文三步走操作，99%的问题都能解决。

你在用QField时还遇到过哪些奇葩报错？或者有什么独家避坑技巧？欢迎在评论区留言，我会一一回复。下期我们讲《QField采集的数据怎么批量导回QGIS？》，记得关注不迷路！