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

wowwwai GIS研习社 · 工具流程与项目排障

QField连接QGIS失败?工程文件怎么传? 这是很多刚开始做外业采集的 GIS 用户都会遇到的问题：电脑上的 QGIS 工程已经配好了图层、样式和表单，但手机里的 QField 要么连不上 QGIS，要么打开工程后图层丢失、底图不显示、数据不能编辑。本文按“连接失败排查”和“工程文件传输”两条线，把 QField 与 QGIS 的常用工作流讲清楚。

引言：QField连接QGIS失败时，先确认你要用哪种方式

很多人说“QField 连接 QGIS 失败”，其实背后可能是三种不同场景：

• 想让手机 QField 直接连接电脑上的 QGIS 工程。
• 想把 QGIS 工程文件传到手机，在 QField 中离线采集。
• 已经采集完数据，想把 QField 数据同步回 QGIS。

在实际外业中，最稳定的方式通常不是让手机实时连接电脑，而是使用 QFieldSync 插件把 QGIS 工程打包成 QField 可用的离线工程，再复制到手机或通过云端同步。这样可以避免网络不稳定、路径不一致、图层引用丢失等问题。

简单判断：如果你是在野外采点、核查地块、更新管线属性，优先使用“QFieldSync 打包离线工程”；如果你只是临时测试，可以再考虑 USB、局域网或云同步方式。

背景：QField 工程文件为什么不能直接随便复制

QGIS 工程文件通常是 .qgz 或 .qgs。它本质上保存的是图层路径、样式、表单、坐标系、标注、插件配置等信息，而不是一定把所有数据都包含在工程文件里面。

这就是很多 QField 工程传输失败的根本原因：你只复制了工程文件，却没有复制工程引用的数据文件。

例如，一个 QGIS 工程可能引用了这些数据：

• 矢量数据：Shapefile、GeoPackage、PostGIS 图层、GeoJSON。
• 栅格数据：GeoTIFF、MBTiles、XYZ 在线底图。
• 附件字段：照片、PDF、巡查记录文件。
• 样式和表单：QGIS 图层样式、默认值、编辑控件、约束条件。

如果电脑上的图层路径是 D:GISdatasurvey.shp，手机上没有这个路径，QField 打开工程时就会找不到图层。QField连接QGIS失败或者工程打开空白，多数不是软件坏了，而是数据路径和工程打包方式不正确。

原理：QField 与 QGIS 的正确关系

QField 是面向移动端的 QGIS 外业采集工具。它可以读取 QGIS 工程中的图层、样式、表单和编辑规则，但它不等于手机上的完整 QGIS。

一个稳定的 QField 工作流通常包含四步：

1. 在电脑 QGIS 中整理工程、图层和表单。
2. 使用 QFieldSync 插件将工程打包为移动端项目。
3. 把打包后的项目文件夹传到手机 QField。
4. 外业采集完成后，将修改后的数据同步回 QGIS。

这里最关键的概念是 相对路径 和 离线数据包。

相对路径表示工程文件引用同一项目文件夹下的数据，例如 data/plots.gpkg。这样不管文件夹放在电脑还是手机，只要内部结构不变，QField 都能找到图层。

离线数据包则是把适合外业编辑的数据复制或转换到一个项目文件夹中。对于很多外业项目，推荐使用 GeoPackage 作为主数据格式，因为它是单文件数据库，适合保存点、线、面图层，也比 Shapefile 更方便管理中文字段、样式和多个图层。

步骤：QField工程文件怎么传才不容易出错

步骤一：在 QGIS 中整理工程

先在电脑端打开 QGIS 工程，检查以下内容：

• 所有需要外业编辑的图层能正常加载。
• 图层坐标系正确，工程坐标系与外业使用场景一致。
• 属性表字段名称清晰，不使用过长、重复或含特殊符号的字段名。
• 需要采集照片时，提前设计好附件字段或照片路径字段。
• 对外业人员不需要编辑的图层设置为只读或作为参考图层。

如果你使用 Shapefile，注意它由多个文件组成，例如 .shp、.shx、.dbf、.prj。只复制一个 .shp 文件会导致 QField 无法正确读取。因此，在 QField 项目中更推荐把外业编辑数据整理成 GeoPackage。

步骤二：安装并使用 QFieldSync 插件

在 QGIS 中打开插件管理器，搜索并安装 QFieldSync。安装完成后，一般可以在菜单或工具栏中看到 QFieldSync 相关功能。

常见操作流程如下：

1. 打开需要发布到 QField 的 QGIS 工程。
2. 保存工程文件，建议保存为 .qgz。
3. 打开 QFieldSync 的项目配置工具。
4. 为每个图层设置同步策略，例如复制、离线编辑、只读参考。
5. 选择导出目录，例如 D:QFieldProjectsproject_001。
6. 生成 QField 项目包。

如果图层需要外业编辑，通常选择可离线编辑或复制到项目中；如果只是背景参考，例如行政区边界、影像索引、道路底图，可以设置为只读参考图层。

步骤三：把完整项目文件夹传到手机

QField工程文件怎么传？重点是传“完整文件夹”，不是只传 .qgz 文件。

你可以使用以下方式：

• USB 数据线：把 QFieldSync 导出的整个文件夹复制到手机存储中。
• 局域网传输：使用文件共享、局域网传输工具或手机文件管理器。
• 云盘同步：使用支持文件夹同步的云盘，但要注意同步完成后再打开工程。
• QFieldCloud：适合团队协作、多人采集和数据版本管理。

复制后，在手机 QField 中打开项目文件夹里的 .qgz 工程。不要只打开数据文件，也不要把工程文件单独移动到其他目录，否则相对路径可能失效。

步骤四：在 QField 中测试工程

正式外业前，建议在办公室先做一次完整测试：

1. 打开 QField 工程。
2. 检查底图、矢量图层和标注是否显示。
3. 新增一条测试点、线或面要素。
4. 填写属性表单，检查下拉框、默认值、必填项是否正常。
5. 测试拍照或附件字段是否能保存。
6. 关闭工程后重新打开，确认数据没有丢失。

如果这一步通过，说明 QField 工程文件传输基本正确。如果在办公室测试都失败，不建议直接带到野外使用。

步骤五：外业采集后同步回 QGIS

外业完成后，把手机中的整个项目文件夹复制回电脑。然后在 QGIS 中使用 QFieldSync 的同步功能，将移动端修改合并回原工程或原始数据。

同步前建议先备份桌面端原始工程和数据。特别是多人同时采集时，不要直接覆盖原始数据文件，否则容易造成数据丢失或版本混乱。

常见坑：QField连接QGIS失败的高频原因

只复制了 .qgz 工程文件

这是最常见的问题。QGIS 工程文件保存的是引用关系，不一定包含数据本身。只复制 .qgz 到手机，QField 很可能显示图层不可用。

使用了电脑绝对路径

如果工程中图层路径指向 C:Users... 或 D:data...，手机端无法识别。应通过 QFieldSync 打包，或把工程和数据组织成相对路径。

在线底图在外业环境中打不开

很多用户在电脑上能看到 XYZ 在线底图，但到野外没有网络，QField 就显示空白。解决方法是提前准备离线底图，例如 MBTiles、GeoPackage 栅格或本地缓存底图。

图层格式不适合移动端编辑

PostGIS、WFS、某些网络服务图层在移动端外业环境中依赖网络和权限，不一定适合离线编辑。对普通外业采集，GeoPackage 通常更稳。

字段和表单没有提前设计

QField 可以继承 QGIS 的编辑表单设置。如果你没有在 QGIS 中配置下拉选项、默认值、必填字段和字段别名，外业人员在手机上填写属性时就容易出错。

手机权限没有打开

如果 QField 无法访问项目目录、照片或定位信息，需要检查 Android 或 iOS 的文件访问、相机和定位权限。尤其是新版移动系统，对应用访问文件夹的权限限制更严格。

文件夹同步没有完成就打开工程

使用云盘或即时通讯工具传输时，部分大文件可能还没下载完成。此时打开 QField 工程，会出现图层缺失或数据库锁定问题。建议确认项目文件夹完整后再打开。

方法比较：QField工程文件传输方式怎么选

如果你是第一次使用 QField，建议从“QGIS 整理工程 → QFieldSync 打包 → USB 复制到手机 → QField 采集 → 同步回 QGIS”这条流程开始。它最容易定位问题，也最适合教学、实习和单人外业采集。

检查清单：发布 QField 工程前逐项确认

• QGIS 工程已经保存为 .qgz，并能在电脑端正常打开。
• 所有外业需要编辑的图层已经确认字段、表单和样式。
• 项目图层尽量使用相对路径或通过 QFieldSync 统一打包。
• 外业编辑数据优先使用 GeoPackage，而不是零散 Shapefile。
• 在线底图已经评估网络条件，必要时准备离线底图。
• 照片、附件、默认值、下拉框、必填项已经在 QGIS 中测试。
• QFieldSync 导出后，复制的是完整项目文件夹。
• 手机端 QField 已授予定位、相机和文件访问权限。
• 正式外业前已经新增测试要素，并成功保存。
• 采集完成后，先备份再同步回 QGIS。

FAQ：QField连接QGIS失败与工程传输常见问题

QField 可以直接打开 QGIS 工程吗？

可以打开很多 QGIS 工程，但不建议直接把电脑上的 .qgz 单独复制到手机。更推荐使用 QFieldSync 打包，因为它能处理数据路径、图层复制和同步策略，减少 QField连接QGIS失败的概率。

QField工程文件怎么传最稳？

最稳的方法是先用 QFieldSync 导出项目，再通过 USB 数据线复制完整项目文件夹到手机。注意是整个文件夹，包括工程文件、GeoPackage、样式、附件目录和离线底图，不是只传一个工程文件。

为什么 QField 打开工程后图层全是红色感叹号？

通常是图层路径失效或数据文件没有一起复制。检查项目文件夹中是否包含数据文件，尤其是 Shapefile 的多个组成文件，或改用 QFieldSync 重新打包。

QField 支持 Shapefile 吗？

支持，但外业编辑时不如 GeoPackage 方便。Shapefile 文件分散、字段限制多、编码问题常见。对于新项目，建议将采集图层保存为 GeoPackage。

QField 中能显示在线天地图或 XYZ 底图吗？

在有网络、服务地址可访问、授权正常的情况下可以显示。但外业环境网络不稳定时，在线底图容易加载失败。重要项目建议准备 MBTiles 或其他离线底图。

QField 采集的数据怎么回到 QGIS？

把手机中的项目文件夹复制回电脑，然后使用 QFieldSync 的同步功能把修改合并回原工程。不要在没有备份的情况下直接覆盖原始数据。

多人同时用 QField 采集会不会冲突？

可能会。多人采集时需要明确每个人的采集范围、项目副本和回传顺序，或者使用 QFieldCloud 这类协作方式管理同步和版本，避免互相覆盖。

QField连接QGIS失败是不是版本不兼容？

版本差异可能造成问题，但更常见的原因是路径、数据格式、权限和同步方式不正确。排查时先检查工程是否完整打包、数据是否在项目文件夹内、手机权限是否开启，再考虑升级 QGIS、QField 和 QFieldSync。

结论：把 QGIS 工程变成可移动的 QField 项目

处理 QField连接QGIS失败，不要只盯着“连接”本身，而要看工程、数据、路径、权限和同步流程是否完整。QField 外业采集的核心不是把一个 .qgz 文件发到手机，而是把 QGIS 工程整理成一个可在移动端独立运行的项目包。

推荐的稳定流程是：在 QGIS 中设计图层和表单，使用 QFieldSync 打包，复制完整项目文件夹到手机，在 QField 中测试采集，外业结束后再同步回 QGIS。只要按这个流程做，QField工程文件怎么传、图层为什么丢失、数据怎么回传这些问题都会清晰很多。