QField连接QGIS失败?工程文件怎么传?
引言
“QField连接QGIS失败?工程文件怎么传?”是很多刚开始做外业采集的 GIS 用户都会遇到的问题：在电脑上用 QGIS 配好了图层、样式和表单，到了 QField 里却不知道怎么同步，或者手机无法连接到电脑上的 QGIS。
先说结论：QField 通常不是像远程桌面那样“直接连接 QGIS 软件”，而是通过 QFieldSync 插件打包工程、通过 QFieldCloud 同步，或通过数据线、局域网、网盘等方式把工程文件和数据传到移动端。连接失败时，重点要检查工程路径、图层数据是否一起复制、坐标系、附件路径和同步方式。
背景
QField 是面向移动端外业采集的 GIS 应用，常用于地物调查、巡检、样点采集、管线核查和影像底图查看。它和 QGIS 的关系很紧密，但很多新手会误以为：只要手机和电脑在同一个网络里，QField 就能自动连接 QGIS。
实际工作中，QField 更常见的使用方式有三种：
- 本地打包传输：在 QGIS 中用 QFieldSync 插件打包工程，把整个文件夹复制到手机。
- QFieldCloud 同步：通过云端上传和下载工程，适合多人协作和反复同步。
- 手动复制工程：直接复制 .qgz、GeoPackage、Shapefile、照片文件夹等数据，但需要自己处理路径问题。
所以，当你遇到 QField 连接 QGIS 失败、QField 打不开 QGIS 工程、图层丢失、照片无法显示等问题时，不要只盯着“连接”两个字，而要先判断你使用的是哪一种工程传输方式。
原理
QGIS 工程文件通常是 .qgz 或 .qgs。它本身主要保存图层引用、样式、标注、表单、坐标系、插件配置等信息。也就是说，工程文件不一定包含真实数据。
举个常见例子：你在 QGIS 中加载了一个 Shapefile，工程文件里记录的是这个 Shapefile 的路径。如果你只把 .qgz 发到手机，而没有把 .shp、.dbf、.shx、.prj 等配套文件一起复制，QField 打开工程时就会提示图层不可用。
QFieldSync 的作用，就是把 QGIS 工程中适合外业使用的图层、样式和表单配置整理到一个移动端工程包里。它会尽量把复杂的路径关系转换为更适合移动设备读取的结构，减少 QField 工程文件传输后的图层丢失问题。
理解这一点后，排查 QField 连接 QGIS 失败就会清楚很多：问题通常不是 QField 不认识 QGIS，而是工程、数据、路径、权限或同步方式没有处理好。
步骤
步骤一：在 QGIS 中先整理工程
在传输到 QField 之前，先在电脑端 QGIS 中把工程整理干净。不要一边外业采集一边临时修工程结构，这样很容易出现路径混乱。
- 打开 QGIS 工程，确认所有图层都能正常显示。
- 检查图层是否来自本地文件、数据库、在线服务或临时图层。
- 把需要外业编辑的图层优先保存为 GeoPackage 格式。
- 删除不需要带到外业的测试图层、临时图层和失效图层。
- 保存工程为 .qgz 格式。
如果你的图层来自 PostGIS、WFS、在线 XYZ 瓦片或公司内网服务，要注意手机外业环境是否能访问这些服务。很多“QField连接QGIS失败”的表象，实际是移动端访问不到数据源。
步骤二：安装并使用 QFieldSync 插件
推荐通过 QFieldSync 来准备 QField 工程文件。它比手动复制更稳，尤其适合包含多个矢量图层、表单和照片附件的项目。
- 在 QGIS 中打开插件管理器。
- 搜索并安装 QFieldSync 插件。
- 打开需要传输的 QGIS 工程。
- 在 QFieldSync 中检查图层同步动作，例如复制、离线编辑、仅显示等。
- 选择导出目录，生成 QField 可用的工程文件夹。
对于需要现场新增、修改、删除要素的图层，通常应设置为可编辑或离线编辑。对于只作为底图或参考的图层，可以设置为只读或复制。
步骤三：把工程文件夹传到手机
QField工程文件怎么传，取决于你的设备和项目管理方式。最稳妥的办法是传整个工程文件夹，而不是只传 .qgz 文件。
- USB 数据线：适合 Android 设备，直接把 QFieldSync 导出的文件夹复制到手机存储中。
- QFieldCloud：适合多人协作、频繁同步、需要回传外业成果的项目。
- 局域网或文件共享：适合同一办公网络内临时传输。
- 网盘或聊天工具：可以应急使用，但要注意压缩包解压后路径不能乱。
如果使用 Android 手机，建议把工程放在一个容易找到的位置，例如设备存储中的 QField 项目目录。不同 Android 版本对应用访问文件的权限限制不同，如果 QField 找不到文件，可以尝试在 QField 内部的文件选择器中重新定位工程。
步骤四：在 QField 中打开工程
打开 QField 后，不要只找单个数据文件，而要打开 QGIS 工程文件，也就是 .qgz 或 .qgs。正确打开后，QField 会按照工程配置加载图层、样式、表单和采集规则。
- 打开 QField。
- 选择本地文件或项目目录。
- 找到 QFieldSync 导出的工程文件夹。
- 打开其中的 .qgz 工程文件。
- 检查图层列表、地图显示、定位功能和编辑表单。
如果打开后地图是空白的，先不要急着重装软件。可以检查坐标系、图层路径、地图范围和数据是否真的被复制到了手机。
步骤五：外业采集后同步回 QGIS
如果你的工作流需要把 QField 中采集的数据带回 QGIS，要从一开始就设计好回传方式。
- 使用 QFieldSync 时，可以按插件工作流导入修改后的数据。
- 使用 QFieldCloud 时，可以在云端同步后由电脑端 QGIS 获取更新。
- 手动复制时，要把编辑后的 GeoPackage、照片附件和相关文件一起复制回电脑。
特别注意照片附件。很多外业项目的照片路径是相对路径，如果只复制矢量数据，不复制照片文件夹，回到 QGIS 后就会出现属性表有照片字段但图片无法打开的情况。
常见坑
只复制 .qgz 工程文件
这是最常见的问题。QGIS 工程文件通常只是“项目配置”，不是完整数据包。只复制 .qgz 到手机，QField 很可能找不到图层数据。
正确做法是复制 QFieldSync 生成的整个文件夹，或者手动确保所有数据文件都在同一套相对路径结构中。
Shapefile 文件没有复制完整
Shapefile 不是一个单文件格式。至少常见的 .shp、.shx、.dbf、.prj 都应一起复制。如果缺少 .dbf，属性可能丢失；如果缺少 .prj，坐标系可能无法正确识别。
外业采集项目更推荐使用 GeoPackage，因为它通常是单文件，能同时存储多个图层，移动端管理更简单。
工程路径使用了电脑绝对路径
如果 QGIS 工程中引用的是类似电脑磁盘路径的绝对路径，手机上当然找不到。例如 Windows 中的某个盘符路径，在 Android 设备上不存在。
用 QFieldSync 打包，或在 QGIS 中尽量使用相对路径，可以减少这类问题。
在线底图在外业现场无法访问
很多项目在办公室 Wi-Fi 下测试正常，到野外就加载失败。这通常不是 QField 本身的问题，而是现场网络不稳定，或者在线地图服务被限制访问。
如果外业区域网络条件差，建议提前准备离线底图，例如 MBTiles、GeoPackage 栅格或已经缓存好的离线瓦片。
坐标系不一致导致地图看起来空白
有时图层其实已经加载，但因为坐标系设置错误，地图显示范围偏到了很远的位置。尤其是经纬度坐标、投影坐标、本地坐标混用时，容易出现这种情况。
在 QGIS 中先确认图层坐标系和工程坐标系，并使用“缩放到图层”检查数据范围。传到 QField 后，也可以通过图层定位判断是否是坐标系问题。
手机没有授予文件或定位权限
QField 需要访问工程文件、照片存储和 GPS 定位。若手机系统没有授予权限，可能会出现打不开工程、无法保存照片、无法定位等问题。
进入手机系统设置，检查 QField 的文件访问、相机、位置权限是否已经开启。
方法比较
| 传输方法 | 适合场景 | 优点 | 注意事项 |
|---|---|---|---|
| QFieldSync 打包 | 单人或小团队外业采集 | 路径更稳定，适合 QGIS 到 QField 的标准工作流 | 需要先在 QGIS 中正确配置图层同步动作 |
| QFieldCloud | 多人协作、频繁同步、长期项目 | 同步方便，适合采集成果回传 | 需要账号、网络和项目权限管理 |
| USB 手动复制 | 简单项目、离线环境 | 直接、可控，不依赖云服务 | 必须复制完整文件夹，避免漏数据 |
| 网盘或压缩包 | 临时分发工程 | 跨设备方便 | 解压路径和文件权限容易出问题 |
| 直接引用在线服务 | 有稳定网络的查看型项目 | 数据无需完全复制到本地 | 外业网络不稳定时风险较高 |
如果你只是想把 QGIS 工程带到手机上查看和采集，优先选择 QFieldSync。如果你需要多人同时采集并回传成果，优先评估 QFieldCloud。如果只是临时测试，小工程可以手动复制，但一定要复制完整数据。
检查清单
遇到 QField 连接 QGIS 失败或 QField 打不开工程时，可以按下面的顺序排查：
- QGIS 工程在电脑端是否能正常打开？
- 所有图层在 QGIS 中是否没有红色失效提示？
- 是否安装并正确使用了 QFieldSync？
- 是否复制了整个工程文件夹，而不是只复制 .qgz？
- Shapefile 的 .shp、.shx、.dbf、.prj 是否齐全？
- 是否存在电脑绝对路径，导致手机无法识别？
- 外业编辑图层是否使用了适合移动端的格式，例如 GeoPackage？
- 照片附件目录是否一起复制？
- 在线底图在手机网络下是否能访问？
- QField 是否具有文件、位置、相机权限？
- 图层坐标系和工程坐标系是否正确？
- 是否尝试在 QField 中缩放到图层范围？
FAQ
QField 可以直接连接正在运行的 QGIS 吗？
通常不把 QField 理解为直接远程连接 QGIS。更常见的方式是通过 QFieldSync、QFieldCloud 或文件复制，把 QGIS 工程和数据传到移动端使用。你需要关注的是工程和数据是否完整同步，而不是手机是否“连上”电脑上的 QGIS 界面。
QField工程文件怎么传最稳？
最稳的方法是用 QFieldSync 在 QGIS 中导出移动端工程，然后把导出的整个文件夹传到手机。不要只传 .qgz 文件，也不要随意改变导出文件夹内部结构。
为什么 QField 打开工程后图层都不见了？
常见原因包括数据文件没有复制、路径还是电脑绝对路径、Shapefile 文件缺失、图层来自数据库或在线服务但手机无法访问。建议先回到 QGIS 检查图层来源，再用 QFieldSync 重新打包。
QField 支持 Shapefile 吗？
QField 可以使用 Shapefile，但外业项目更推荐 GeoPackage。因为 Shapefile 由多个文件组成，传输时容易漏文件；GeoPackage 通常是单文件，更适合移动端保存和同步。
QField 采集的照片回到 QGIS 后打不开怎么办？
优先检查照片文件夹是否复制回电脑，以及属性表中保存的照片路径是否仍然有效。如果使用相对路径，应保持照片目录和工程文件的相对位置不变。使用 QFieldSync 或 QFieldCloud 可以减少附件路径错误。
手机上地图空白是不是数据丢了？
不一定。地图空白可能是图层未加载，也可能是坐标系错误、地图范围不对、在线底图无法访问。可以在 QField 中尝试缩放到图层，或在 QGIS 中检查数据范围和坐标系。
能不能直接把 QGIS 工程发到微信或网盘再用 QField 打开？
可以应急，但不推荐只发送单个工程文件。最好把 QFieldSync 导出的工程文件夹压缩后发送，手机端完整解压，再从 QField 中打开 .qgz 工程。否则很容易出现路径和附件丢失问题。
结论
处理“QField连接QGIS失败?工程文件怎么传?”这类问题时，核心思路是：不要把它当成单纯的网络连接故障，而要把它看成 QGIS 工程、图层数据、路径结构和移动端权限之间的同步问题。
实际项目中，推荐先在 QGIS 中整理工程，再使用 QFieldSync 打包，最后把完整工程文件夹传到 QField。对于多人协作和长期外业项目，可以使用 QFieldCloud 管理同步。只要工程文件、图层数据、附件和坐标系都处理正确，QField 与 QGIS 的配合会非常稳定。
如果你正在做第一次外业采集测试，建议用一个小范围样例工程先完整走一遍：QGIS 配置、QFieldSync 打包、手机打开、采集编辑、照片附件、成果回传。这个流程跑通后，再迁移到正式项目，会少踩很多坑。