做GIS的应该都有过这种经历领导说“把图斑名字标出来”常规操作是先打开图层属性翻到“标注”选项卡勾上“标注该图层”再选字段、调字体、调位置一套流程下来时间没少花。后来我用QGIS时眼睛扫到标注工具栏上那个带“ABC”的小按钮点了之后直接弹出一个字段列表选完字段图面立刻标满名字——那个按钮就是标题里说的快速标注按钮。这一篇就专门聊聊它它到底帮你做了什么、点完以后怎么继续精细调整、遇到标注不显示或位置乱跳怎么排查以及怎么把它真正用进日常出图流程。1. 快速标注按钮的本质一个帮你“偷懒”的入口1.1 这个按钮在工具栏的哪里、长什么样先解决最实际的问题这个按钮在哪。QGIS界面里标注相关工具集中在“标注”工具栏Label Toolbar默认布局下不一定显示。你需要在顶部菜单栏找到“视图 → 工具栏”把“标注”勾上界面里就会出现一排和标签相关的图标。快速标注按钮的图标在不同版本、不同汉化包里长得不太一样但基本都带“ABC”或者“标签”字样。QGIS 3.x版本里鼠标悬停在按钮上会显示“Add Label”添加标注部分汉化版本直接翻译成“快速标注”。旧一点的QGIS 2.x版本里标注工具栏中间有一个下拉框和一个“图层标注设置”按钮那个下拉框本质也是快速选择字段做标注。说白了不同叫法不同位置核心逻辑完全一致选个字段让QGIS自动把要素名字标出来。这里要提醒一句如果你用的是汉化版界面按钮名字不一定叫“快速标注”可能叫“添加标注”“快速标签”之类的。认准图标比认准文字更靠谱。我自己的习惯是先把标注工具栏拖到常用工具栏区域下次要用直接瞄图标就行。1.2 点一下QGIS背后替你做了两件事很多教程教完点击按钮就结束了但我一直觉得搞清楚按钮背后发生了什么后面出问题才好排查。快速标注按钮实际上只做了两件事。第一件事给图层设置一个标注字段。你在弹出的字段列表里选“名称”也好选“地类代码”也好本质上是在告诉QGIS把每个要素的这个字段内容显示在要素旁边。如果这个字段是文本类型直接显示如果是数字类型QGIS也会自动转成字符串显示如果字段值是空的那个要素通常就不标。第二件事打开这个图层的自动标注开关。QGIS里每个矢量图层都有一个“标注”开关类似灯一样的东西。开关不开你就算在设置里写满了表达式图面也什么都看不见。快速标注按钮帮你把开关打开了这就是为什么你点完按钮图面刷一下就出现文字的原因。搞清楚这两点以后你就能理解一个关键规律快速标注按钮只是入口不是终点。它做的设置全部落在“图层标注设置”对话框里。你后续想改字体、改颜色、调位置、写表达式仍然回到那个对话框操作。很多初学者以为点了快速标注按钮就不能再改了纯属误会。1.3 和传统“图层属性→标注”的方式相比省了什么为了说清楚价值我做了一张简单的对比表把两种路径从头到尾捋了一遍。对比项传统方式图层属性→标注快速标注按钮入口步骤图层属性对话框→标注选项卡选中图层→点击工具栏按钮勾选开关手动勾选“标注该图层”自动完成选择字段在下拉框里选字段弹出字段列表选字段首次出现标注需要点“应用”或“确定”后刷新选完字段立即出现在画布后续精细调整回到标注选项卡继续改同样回到“图层标注设置”改适合场景需要一次性配置一整套标注样式快速看标注效果、临时出图、做方案雏形从实际操作感受来说快速标注按钮最大的价值是“即时反馈”。你选了一个字段图面文字立刻出现用视觉判断这个字段适不适合做标注比打开对话框反复试效率高得多。尤其是做方案设计时我经常用快速标注把好几个字段轮流试一遍看完效果再决定最终用哪个这比闷头在设置里改字段、点确定、再改、再确定快了不止一倍。但我必须说句公道话如果你要做的是精细出图比如一整套图例字体、引线、避让规则、按地类分别标注那起点仍然是“图层标注设置”对话框。快速标注按钮负责把你“带进门”剩下的装修得靠你自己来。2. 上手实操从选中图层到标出一张像样的图2.1 准备工作加载数据和图层实操之前先确认几件事。第一你要标注的必须是矢量图层点、线、面都行栅格影像不能直接标除非你先做矢量化。第二图层要有至少一个字段能拿来当标注内容比如名称、编号、类型代码。第三也是很多新手最容易忽略的图层得在地图画布的可视范围内并且坐标系设置合理否则标注是生成了但显示在画布之外。我做演示时习惯用一份用地数据字段有“地块编号”“地类名称”“面积”几个。下面所有步骤都围绕这份数据展开你可以直接替换成自己的图层。2.2 四步完成基础标注第一步在图层面板里单击选中要标注的图层。注意是选中不是双击打开属性也不是勾选图层前面的可见性框。如果这个步骤没做对后面点快速标注按钮QGIS不知道给谁标。第二步在标注工具栏上点击快速标注按钮。如果按钮是灰色不可点击多半是当前没有选中的矢量图层检查一下图层面板。第三步在弹出的下拉列表里选择要标注的字段。我第一步选了“地块编号”图面上立刻出现一排排数字编号。这个下拉列表框的底部通常还有一个“表达式…”入口点进去可以写自定义表达式这个后面细说。第四步看效果。如果标注没出来往下翻第三章节我整理了常见原因和排查顺序。如果标注出来了但是字体太小、颜色和底图混在一起点标注工具栏上的“图层标注设置”按钮通常是一个带铅笔或齿轮的小图标在里面调整字号、颜色、描边。这里有一个我踩过多次的坑快速标注按钮默认是给“选中图层”的但是如果你用了“按范围选择”或者开了“图层编辑模式”某些版本可能会把快速标注作用在“当前活动图层”上。我的建议是操作前养成看状态栏的习惯状态栏左侧会显示当前活动图层名确保它和你要标注的图层一致。2.3 用表达式做“分式标注”等复合效果快速标注按钮自带的字段列表只能选单一字段但实际项目中经常需要“分子分母”式标注。比如测绘和规划里常见的分式标注上面写地类编号下面写地类名称中间一条横线。这种效果怎么实现答案在刚才提到的“表达式…”入口里。在快速标注的字段下拉列表底部选择“表达式…”QGIS会打开表达式对话框。这里你可以用字符串拼接符||和换行符\n构造多行文本。以我的用地数据为例表达式这样写地块编号 || \n || 地类名称确定以后图面上每个地块会显示两行文字第一行是地块编号第二行是地类名称。如果还想加一条横线可以改成地块编号 || \n || -------- || \n || 地类名称不过实际出图时我更喜欢用短横线或下划线比如________具体看你图面的审美需求。表达式写完之后你可以再进“图层标注设置”的“格式化”选项卡把多行文字设为“水平居中”和“垂直居中”行间距适当调小出来的效果就很接近传统制图里的分式标注了。再补充一个场景线状要素的里程标注。比如道路图层你想在每个路口附近标上桩号单纯标一个里程字段不好看可以用表达式K || round($length / 1000, 3)这里的$length是要素实际长度单位是米除以1000换算成公里加上字母K以后图面显示类似“K2.345”。这种方法在做管线、道路标注时非常好用本质也还是快速标注入口里那个表达式框的事。2.4 快速标注加上简单的数据分级颜色标注不仅仅是文字字号和颜色也可以跟着字段值变化。这里用到的功能叫“数据定义覆盖”Data Defined Override入口在“图层标注设置”对话框中每个属性颜色、字号、字距、旋转角度等右侧都有一个小圆箭头。点击字号旁边的圆箭头选择“编辑…”写一个条件表达式。比如按面积大小分级CASE WHEN 面积 1000 THEN 14 WHEN 面积 500 THEN 11 ELSE 8 END意思是面积大于1000平方米的块用14号字500到1000用11号字小于500用8号字。这样图面自动形成层级感重点区域一眼就能抓出来。颜色同理。按地类名称映射颜色CASE 地类名称 WHEN 建设用地 THEN #E31A1C WHEN 耕地 THEN #FFFF99 WHEN 林地 THEN #33A02C ELSE #C0C0C0 END写完之后点击“确定”图面上的标注颜色会几乎实时刷新。这个功能熟练以后你会发现自己在标注上“做文章”的能力一下子扩展了很多快速标注按钮只是引子真正的潜力都在表达式里。3. 标注不显示、位置乱跳的排查链路3.1 点完按钮图面空白先查图层类型和开关标注没出现是初学者问得最多的问题。我的排查顺序从来都是固定的按顺序查基本五分钟内能定位。第一步看图层是不是矢量图层。栅格影像、点云、网格数据不支持直接标注不会显示在标注工具栏的可操作范围内。把这个问题排在最前面是因为我见过有人在栅格上点了半天快速标注最后发现图层类型不对。第二步看图层面板里目标图层是否处于“选中”状态。很多版本里快速标注作用在选中图层如果没选中按钮点了可能没有任何反应。第三步打开“图层标注设置”看“标注该图层”开关是否打开了。快速标注按钮理论上会帮你自动打开但如果你在版本升级前后经历过设置迁移或者之前手动关闭过这个开关可能处于关闭状态。手动勾上点应用标注马上出来。第四步看字段值是否有内容。如果标注字段全为空值图面上自然一个文字都没有。这个很容易漏因为数据表里看着有内容但可能是空格或者不可见字符。用“打开属性表”检查那个字段确认值不是空字符串。3.2 标注互相压盖、歪七扭八避让算法和放置选项标注自动生成以后出现最多的问题就是文字互相压盖。QGIS的自动标注底层有一套避让算法内部叫pal labeling就是Placement Algorithm的缩写默认会把标注放在“要素周围最不拥挤的地方”。但自动算法不代表每次都对尤其是要素密集、文字又长的时候难免还是会有压盖。这时候不要慌张先去“图层标注设置”的“置放”选项卡。里面有几个参数需要重点看。一个是“标注优先级”数值越高这个要素的标注在冲突时越有资格优先显示。比如重点地块设优先级10普通地块设1压盖冲突时普通标注会被隐藏重点标注保留下来。另一个参数是“距离”和“偏移”。面要素标注默认在内部居中线要素默认沿线放置点要素默认围绕点放置。如果文字和符号蹭在一起可以增大“距离”值让文字离符号远一点。还有一个容易被忽视的是“障碍物”概念。QGIS会把图层要素本身当作障碍物也会把其他图层当成障碍物。如果你的底图上有大量注记或要素标注会为了让位置而到处跑。这时可以在“置放”选项卡下方找到“仅放置可显示标注的要素”之类选项或者调整图层顺序来减少干扰。3.3 中文乱码或显示成方块字体和编码问题中文显示异常是QGIS中文用户绕不开的坎。快速标注按钮用的是你当前图层样式里的字体设置如果字体不支持中文就会显示成一排方块豆腐块。解决办法进入“图层标注设置”在“文字格式”选项卡里把字体改成“微软雅黑”“SimHei”或者“思源黑体”这些中文字体。如果字体列表里没有中文字体说明这台机器的操作系统里没装装一个字体后重启QGIS就出来了。另一类和中文有关的问题是乱码。老旧的shapefile数据经常是GBK编码QGIS默认按UTF-8读取结果中文就变成一堆乱码。这时候你在快速标注里选字段标出来就是乱码。解决办法是在“图层属性 → 数据源”里找到“数据源编码”之类的设置把编码改成“GBK”或“GB2312”重新加载图层。如果文件旁边有.cpg文件QGIS会自动读取但很多老数据根本没有.cpg就得手动指定。记得遇到过最隐蔽的一种情况字段在属性表里看起来正常标注却乱码原因是字段名和字段值不是同一种编码。这种问题处理起来比较麻烦只能把字段名改成英文字母或者用“字段计算器”把乱码字段统一转成UTF-8再重新标注。3.4 标注位置偏移坐标系是最大嫌疑你可能会遇到一种诡异情况标注位置和要素对不上离得很远或者标注在整个图层的某个角落堆成一团。这种情况十有八九是坐标系问题。具体来说你的图层是WGS84经纬度坐标EPSG:4326但工程显示的是Web墨卡托EPSG:3857或者你通过在线地图服务加载了天地图影像而工程设置又强制了另一个坐标系。QGIS本身有实时重投影功能要素位置能对上但标注生成时参照的坐标系如果混乱文字就会乱跑。排查方法右键图层 → “图层属性 → 数据源”看“坐标系”一栏写的是什么。再打开“工程 → 属性 → 坐标系”看工程坐标系设置。一般做法是把所有来源的图层统一到项目坐标系下或者干脆把矢量图层导出时重投影成和目标底图一致的坐标系。这里补充一个操作技巧右键图层 → “导出 → 另存为”在“CRS”选项里选择你需要的坐标系生成一份新文件用新文件做标注就不会出坐标错乱的问题。尤其是叠加天地图或在线影像时我强烈建议先统一坐标系再标注不然你会在位置偏移上浪费大量时间。3.5 标注时有时无比例尺范围在作怪还有一个常见现象你缩小地图时标注还在放大以后标注反而消失了或者反过来。QGIS里每个图层的标注可以设置“仅在一定比例尺范围内显示”这个功能在“图层标注设置”的“渲染”选项卡里默认是“从不隐藏”但如果你误设了最小/最大比例尺就会遇到这种灵异事件。我实际工作中经常用这个功能控制出图效果。比如大范围图幅上只显示重点区域的地名放大后再显示细碎地块的编号。在“渲染”选项卡里勾选“最小比例尺”和“最大比例尺”用旁边的“当前比例尺”按钮可以直接把当前缩放级别填入。这样设置完以后标注就会按你的缩放范围自动切换显隐。如果发现标注时有时无先去这里看看是不是范围设置太窄了。4. 把快速标注接入你的日常工作流4.1 把标注样式存成.qml实现一秒复用快速标注虽然快但每次拿到新图层都重新点一遍、调一遍效率也谈不上高。我现在的做法是把一套满意的标注设置保存成QGIS样式文件.qml下一次遇到同类数据直接加载样式标注自动全套呈现。操作步骤如下。调好标注后右键图层 → “样式” → “保存样式”选择保存为QGIS图层样式文件.qml。这个文件会把文字格式、颜色、字号、避让设置、表达式全部打包。下次加载一个新图层右键 → “样式” → “加载样式”选这个.qml文件所有标注设置一键就位。这套方法尤其适合工作内容重复度高的场景。比如你每周都要给不同地块分批次出图第一次把标注样式调好后面每次加载新数据直接套样式出图时间可以从半小时压缩到五分钟。.qml文件本质是XML格式用记事本打开能看到里面的字体、颜色、字段表达式。如果你对同一种样式有多个微调版本直接复制几个.qml文件改名字就很方便。需要注意.qml中记录的是字段名如果新图层字段名不一致表达式会失效这点加载样式以后检查一下标注是否有变化。4.2 用PyQGIS批量处理给一堆图层批量加标注工作里还会遇到更头疼的场景一个工程里有二十几个图层每个都要标字段手点二十几次快速标注按钮也不是不行但如果你想在开会前一次性搞定用PyQGIS写个小脚本更方便。打开QGIS菜单“处理 → Python控制台”粘贴以下代码from qgis.core import QgsPalLayerSettings, QgsTextFormat, QgsVectorLayerSimpleLabeling layer iface.activeLayer() field_name 地块编号 # 检查字段是否存在 if layer.fields().indexFromName(field_name) -1: print(字段不存在请检查字段名 field_name) else: settings QgsPalLayerSettings() settings.fieldName field_name fmt QgsTextFormat() settings.setFormat(fmt) labeling QgsVectorLayerSimpleLabeling(settings) layer.setLabeling(labeling) layer.setLabelsEnabled(True) layer.triggerRepaint() print(标注已生成 layer.name())这段代码的逻辑和快速标注按钮完全一致创建一个标注设置对象指定字段启用标注刷新画布。你只要改掉第三行的字段名选中目标图层运行代码就行。如果想批量处理多个图层可以在代码外面包一层循环遍历图层面板里所有图层按图层名匹配字段名。比如for layer in QgsProject.instance().mapLayers().values(): if layer.type() QgsMapLayer.VectorLayer and layer.geometryType() QgsWkbType.PolygonGeometry: if layer.fields().indexFromName(地块编号) ! -1: # 这里复用上面的标注设置逻辑 settings QgsPalLayerSettings() settings.fieldName 地块编号 layer.setLabeling(QgsVectorLayerSimpleLabeling(settings)) layer.setLabelsEnabled(True)这个脚本会把所有面图层里含有“地块编号”字段的图层统一加上标注。涉及“字段不存在”的场景我会加个判断避免报错中断。4.3 出图前把标注转成注记手动微调的最后一步自动标注再智能总有想手动挪一下的时候。比如某个地名和符号重叠位置怎么调都有冲突这时候最直接的办法是把自动标注转成注记Annotation然后手工拖动文字位置。QGIS里有一个操作可以把当前图层的标注转成注记菜单位置不同版本略有差异一般在“图层”菜单或标注工具栏里能找到“将标注转换为注记”或“将标注转换为要素”。执行以后原来由标注引擎自动计算的文字会变成画布上一堆独立的注记对象可以点选、拖动、改字、删除。把标注转成注记之前我强烈建议先把当前配置保存一份.qml备份。因为转完以后标注就和图层样式脱钩了想重新自动排布就得加载备份样式。转换以后每个注记都可以单独选中文本框的位置可以随意调用的还是“移动要素”或“选择要素”那一套工具。这种手动微调在送审图里特别常用审图专家不会管你是不是自动生成的他们只关心文字有没有压到边界线、有没有压到重要地物。4.4 我的个人心得什么时候别用快速标注写了这么多最后说点反话快速标注按钮不是万能的有些场景我不建议用。第一种场景是严格按国标或行业规范出图。规范和模板通常规定字体字高、标注位置、压盖规则靠快速标注的默认设置很难一步到位还是要回到“图层标注设置”里逐项调。第二种场景是要素特别密集的区域。比如城市级路网每条道路都要标路名自动避让算法在这种密度下会很吃力标注可能大面积隐藏或乱跑。这种情况下我一般把标注转为注记手动挑重要道路标或者用“规则标注”按道路等级分别配置。第三种场景是标注内容非常复杂混入了图片、特殊符号、注记框线。这类需求已经超出“标注”本身建议直接用QGIS的“手绘注记”工具或者通过打印布局里的文本框完成。说这些不是劝你弃用快速标注。恰恰相反我几乎每天都会用它——出方案初稿、快速对数据、临时给同事演示它都是效率利器。只是心里要有个判断什么时候快是第一需求什么时候精细是第一需求。快速标注负责前者图层标注设置负责后者两者配合才是在QGIS里玩转标注的完整状态。回到标题那节课的核心快速标注按钮就是QGIS标注体系中那个最容易被忽视、却最实用的入口。它把“选中图层、选个字段、看到标注”压缩成了一次点击把这个入口用熟再往下的避让、表达式、样式管理就都有了一个顺手的起点。希望对刚接触QGIS的朋友有帮助也欢迎和我交流你在标注里遇到的奇葩问题。
做GIS的应该都有过这种经历领导说“把图斑名字标出来”常规操作是先打开图层属性翻到“标注”选项卡勾上“标注该图层”再选字段、调字体、调位置一套流程下来时间没少花。后来我用QGIS时眼睛扫到标注工具栏上那个带“ABC”的小按钮点了之后直接弹出一个字段列表选完字段图面立刻标满名字——那个按钮就是标题里说的快速标注按钮。这一篇就专门聊聊它它到底帮你做了什么、点完以后怎么继续精细调整、遇到标注不显示或位置乱跳怎么排查以及怎么把它真正用进日常出图流程。1. 快速标注按钮的本质一个帮你“偷懒”的入口1.1 这个按钮在工具栏的哪里、长什么样先解决最实际的问题这个按钮在哪。QGIS界面里标注相关工具集中在“标注”工具栏Label Toolbar默认布局下不一定显示。你需要在顶部菜单栏找到“视图 → 工具栏”把“标注”勾上界面里就会出现一排和标签相关的图标。快速标注按钮的图标在不同版本、不同汉化包里长得不太一样但基本都带“ABC”或者“标签”字样。QGIS 3.x版本里鼠标悬停在按钮上会显示“Add Label”添加标注部分汉化版本直接翻译成“快速标注”。旧一点的QGIS 2.x版本里标注工具栏中间有一个下拉框和一个“图层标注设置”按钮那个下拉框本质也是快速选择字段做标注。说白了不同叫法不同位置核心逻辑完全一致选个字段让QGIS自动把要素名字标出来。这里要提醒一句如果你用的是汉化版界面按钮名字不一定叫“快速标注”可能叫“添加标注”“快速标签”之类的。认准图标比认准文字更靠谱。我自己的习惯是先把标注工具栏拖到常用工具栏区域下次要用直接瞄图标就行。1.2 点一下QGIS背后替你做了两件事很多教程教完点击按钮就结束了但我一直觉得搞清楚按钮背后发生了什么后面出问题才好排查。快速标注按钮实际上只做了两件事。第一件事给图层设置一个标注字段。你在弹出的字段列表里选“名称”也好选“地类代码”也好本质上是在告诉QGIS把每个要素的这个字段内容显示在要素旁边。如果这个字段是文本类型直接显示如果是数字类型QGIS也会自动转成字符串显示如果字段值是空的那个要素通常就不标。第二件事打开这个图层的自动标注开关。QGIS里每个矢量图层都有一个“标注”开关类似灯一样的东西。开关不开你就算在设置里写满了表达式图面也什么都看不见。快速标注按钮帮你把开关打开了这就是为什么你点完按钮图面刷一下就出现文字的原因。搞清楚这两点以后你就能理解一个关键规律快速标注按钮只是入口不是终点。它做的设置全部落在“图层标注设置”对话框里。你后续想改字体、改颜色、调位置、写表达式仍然回到那个对话框操作。很多初学者以为点了快速标注按钮就不能再改了纯属误会。1.3 和传统“图层属性→标注”的方式相比省了什么为了说清楚价值我做了一张简单的对比表把两种路径从头到尾捋了一遍。对比项传统方式图层属性→标注快速标注按钮入口步骤图层属性对话框→标注选项卡选中图层→点击工具栏按钮勾选开关手动勾选“标注该图层”自动完成选择字段在下拉框里选字段弹出字段列表选字段首次出现标注需要点“应用”或“确定”后刷新选完字段立即出现在画布后续精细调整回到标注选项卡继续改同样回到“图层标注设置”改适合场景需要一次性配置一整套标注样式快速看标注效果、临时出图、做方案雏形从实际操作感受来说快速标注按钮最大的价值是“即时反馈”。你选了一个字段图面文字立刻出现用视觉判断这个字段适不适合做标注比打开对话框反复试效率高得多。尤其是做方案设计时我经常用快速标注把好几个字段轮流试一遍看完效果再决定最终用哪个这比闷头在设置里改字段、点确定、再改、再确定快了不止一倍。但我必须说句公道话如果你要做的是精细出图比如一整套图例字体、引线、避让规则、按地类分别标注那起点仍然是“图层标注设置”对话框。快速标注按钮负责把你“带进门”剩下的装修得靠你自己来。2. 上手实操从选中图层到标出一张像样的图2.1 准备工作加载数据和图层实操之前先确认几件事。第一你要标注的必须是矢量图层点、线、面都行栅格影像不能直接标除非你先做矢量化。第二图层要有至少一个字段能拿来当标注内容比如名称、编号、类型代码。第三也是很多新手最容易忽略的图层得在地图画布的可视范围内并且坐标系设置合理否则标注是生成了但显示在画布之外。我做演示时习惯用一份用地数据字段有“地块编号”“地类名称”“面积”几个。下面所有步骤都围绕这份数据展开你可以直接替换成自己的图层。2.2 四步完成基础标注第一步在图层面板里单击选中要标注的图层。注意是选中不是双击打开属性也不是勾选图层前面的可见性框。如果这个步骤没做对后面点快速标注按钮QGIS不知道给谁标。第二步在标注工具栏上点击快速标注按钮。如果按钮是灰色不可点击多半是当前没有选中的矢量图层检查一下图层面板。第三步在弹出的下拉列表里选择要标注的字段。我第一步选了“地块编号”图面上立刻出现一排排数字编号。这个下拉列表框的底部通常还有一个“表达式…”入口点进去可以写自定义表达式这个后面细说。第四步看效果。如果标注没出来往下翻第三章节我整理了常见原因和排查顺序。如果标注出来了但是字体太小、颜色和底图混在一起点标注工具栏上的“图层标注设置”按钮通常是一个带铅笔或齿轮的小图标在里面调整字号、颜色、描边。这里有一个我踩过多次的坑快速标注按钮默认是给“选中图层”的但是如果你用了“按范围选择”或者开了“图层编辑模式”某些版本可能会把快速标注作用在“当前活动图层”上。我的建议是操作前养成看状态栏的习惯状态栏左侧会显示当前活动图层名确保它和你要标注的图层一致。2.3 用表达式做“分式标注”等复合效果快速标注按钮自带的字段列表只能选单一字段但实际项目中经常需要“分子分母”式标注。比如测绘和规划里常见的分式标注上面写地类编号下面写地类名称中间一条横线。这种效果怎么实现答案在刚才提到的“表达式…”入口里。在快速标注的字段下拉列表底部选择“表达式…”QGIS会打开表达式对话框。这里你可以用字符串拼接符||和换行符\n构造多行文本。以我的用地数据为例表达式这样写地块编号 || \n || 地类名称确定以后图面上每个地块会显示两行文字第一行是地块编号第二行是地类名称。如果还想加一条横线可以改成地块编号 || \n || -------- || \n || 地类名称不过实际出图时我更喜欢用短横线或下划线比如________具体看你图面的审美需求。表达式写完之后你可以再进“图层标注设置”的“格式化”选项卡把多行文字设为“水平居中”和“垂直居中”行间距适当调小出来的效果就很接近传统制图里的分式标注了。再补充一个场景线状要素的里程标注。比如道路图层你想在每个路口附近标上桩号单纯标一个里程字段不好看可以用表达式K || round($length / 1000, 3)这里的$length是要素实际长度单位是米除以1000换算成公里加上字母K以后图面显示类似“K2.345”。这种方法在做管线、道路标注时非常好用本质也还是快速标注入口里那个表达式框的事。2.4 快速标注加上简单的数据分级颜色标注不仅仅是文字字号和颜色也可以跟着字段值变化。这里用到的功能叫“数据定义覆盖”Data Defined Override入口在“图层标注设置”对话框中每个属性颜色、字号、字距、旋转角度等右侧都有一个小圆箭头。点击字号旁边的圆箭头选择“编辑…”写一个条件表达式。比如按面积大小分级CASE WHEN 面积 1000 THEN 14 WHEN 面积 500 THEN 11 ELSE 8 END意思是面积大于1000平方米的块用14号字500到1000用11号字小于500用8号字。这样图面自动形成层级感重点区域一眼就能抓出来。颜色同理。按地类名称映射颜色CASE 地类名称 WHEN 建设用地 THEN #E31A1C WHEN 耕地 THEN #FFFF99 WHEN 林地 THEN #33A02C ELSE #C0C0C0 END写完之后点击“确定”图面上的标注颜色会几乎实时刷新。这个功能熟练以后你会发现自己在标注上“做文章”的能力一下子扩展了很多快速标注按钮只是引子真正的潜力都在表达式里。3. 标注不显示、位置乱跳的排查链路3.1 点完按钮图面空白先查图层类型和开关标注没出现是初学者问得最多的问题。我的排查顺序从来都是固定的按顺序查基本五分钟内能定位。第一步看图层是不是矢量图层。栅格影像、点云、网格数据不支持直接标注不会显示在标注工具栏的可操作范围内。把这个问题排在最前面是因为我见过有人在栅格上点了半天快速标注最后发现图层类型不对。第二步看图层面板里目标图层是否处于“选中”状态。很多版本里快速标注作用在选中图层如果没选中按钮点了可能没有任何反应。第三步打开“图层标注设置”看“标注该图层”开关是否打开了。快速标注按钮理论上会帮你自动打开但如果你在版本升级前后经历过设置迁移或者之前手动关闭过这个开关可能处于关闭状态。手动勾上点应用标注马上出来。第四步看字段值是否有内容。如果标注字段全为空值图面上自然一个文字都没有。这个很容易漏因为数据表里看着有内容但可能是空格或者不可见字符。用“打开属性表”检查那个字段确认值不是空字符串。3.2 标注互相压盖、歪七扭八避让算法和放置选项标注自动生成以后出现最多的问题就是文字互相压盖。QGIS的自动标注底层有一套避让算法内部叫pal labeling就是Placement Algorithm的缩写默认会把标注放在“要素周围最不拥挤的地方”。但自动算法不代表每次都对尤其是要素密集、文字又长的时候难免还是会有压盖。这时候不要慌张先去“图层标注设置”的“置放”选项卡。里面有几个参数需要重点看。一个是“标注优先级”数值越高这个要素的标注在冲突时越有资格优先显示。比如重点地块设优先级10普通地块设1压盖冲突时普通标注会被隐藏重点标注保留下来。另一个参数是“距离”和“偏移”。面要素标注默认在内部居中线要素默认沿线放置点要素默认围绕点放置。如果文字和符号蹭在一起可以增大“距离”值让文字离符号远一点。还有一个容易被忽视的是“障碍物”概念。QGIS会把图层要素本身当作障碍物也会把其他图层当成障碍物。如果你的底图上有大量注记或要素标注会为了让位置而到处跑。这时可以在“置放”选项卡下方找到“仅放置可显示标注的要素”之类选项或者调整图层顺序来减少干扰。3.3 中文乱码或显示成方块字体和编码问题中文显示异常是QGIS中文用户绕不开的坎。快速标注按钮用的是你当前图层样式里的字体设置如果字体不支持中文就会显示成一排方块豆腐块。解决办法进入“图层标注设置”在“文字格式”选项卡里把字体改成“微软雅黑”“SimHei”或者“思源黑体”这些中文字体。如果字体列表里没有中文字体说明这台机器的操作系统里没装装一个字体后重启QGIS就出来了。另一类和中文有关的问题是乱码。老旧的shapefile数据经常是GBK编码QGIS默认按UTF-8读取结果中文就变成一堆乱码。这时候你在快速标注里选字段标出来就是乱码。解决办法是在“图层属性 → 数据源”里找到“数据源编码”之类的设置把编码改成“GBK”或“GB2312”重新加载图层。如果文件旁边有.cpg文件QGIS会自动读取但很多老数据根本没有.cpg就得手动指定。记得遇到过最隐蔽的一种情况字段在属性表里看起来正常标注却乱码原因是字段名和字段值不是同一种编码。这种问题处理起来比较麻烦只能把字段名改成英文字母或者用“字段计算器”把乱码字段统一转成UTF-8再重新标注。3.4 标注位置偏移坐标系是最大嫌疑你可能会遇到一种诡异情况标注位置和要素对不上离得很远或者标注在整个图层的某个角落堆成一团。这种情况十有八九是坐标系问题。具体来说你的图层是WGS84经纬度坐标EPSG:4326但工程显示的是Web墨卡托EPSG:3857或者你通过在线地图服务加载了天地图影像而工程设置又强制了另一个坐标系。QGIS本身有实时重投影功能要素位置能对上但标注生成时参照的坐标系如果混乱文字就会乱跑。排查方法右键图层 → “图层属性 → 数据源”看“坐标系”一栏写的是什么。再打开“工程 → 属性 → 坐标系”看工程坐标系设置。一般做法是把所有来源的图层统一到项目坐标系下或者干脆把矢量图层导出时重投影成和目标底图一致的坐标系。这里补充一个操作技巧右键图层 → “导出 → 另存为”在“CRS”选项里选择你需要的坐标系生成一份新文件用新文件做标注就不会出坐标错乱的问题。尤其是叠加天地图或在线影像时我强烈建议先统一坐标系再标注不然你会在位置偏移上浪费大量时间。3.5 标注时有时无比例尺范围在作怪还有一个常见现象你缩小地图时标注还在放大以后标注反而消失了或者反过来。QGIS里每个图层的标注可以设置“仅在一定比例尺范围内显示”这个功能在“图层标注设置”的“渲染”选项卡里默认是“从不隐藏”但如果你误设了最小/最大比例尺就会遇到这种灵异事件。我实际工作中经常用这个功能控制出图效果。比如大范围图幅上只显示重点区域的地名放大后再显示细碎地块的编号。在“渲染”选项卡里勾选“最小比例尺”和“最大比例尺”用旁边的“当前比例尺”按钮可以直接把当前缩放级别填入。这样设置完以后标注就会按你的缩放范围自动切换显隐。如果发现标注时有时无先去这里看看是不是范围设置太窄了。4. 把快速标注接入你的日常工作流4.1 把标注样式存成.qml实现一秒复用快速标注虽然快但每次拿到新图层都重新点一遍、调一遍效率也谈不上高。我现在的做法是把一套满意的标注设置保存成QGIS样式文件.qml下一次遇到同类数据直接加载样式标注自动全套呈现。操作步骤如下。调好标注后右键图层 → “样式” → “保存样式”选择保存为QGIS图层样式文件.qml。这个文件会把文字格式、颜色、字号、避让设置、表达式全部打包。下次加载一个新图层右键 → “样式” → “加载样式”选这个.qml文件所有标注设置一键就位。这套方法尤其适合工作内容重复度高的场景。比如你每周都要给不同地块分批次出图第一次把标注样式调好后面每次加载新数据直接套样式出图时间可以从半小时压缩到五分钟。.qml文件本质是XML格式用记事本打开能看到里面的字体、颜色、字段表达式。如果你对同一种样式有多个微调版本直接复制几个.qml文件改名字就很方便。需要注意.qml中记录的是字段名如果新图层字段名不一致表达式会失效这点加载样式以后检查一下标注是否有变化。4.2 用PyQGIS批量处理给一堆图层批量加标注工作里还会遇到更头疼的场景一个工程里有二十几个图层每个都要标字段手点二十几次快速标注按钮也不是不行但如果你想在开会前一次性搞定用PyQGIS写个小脚本更方便。打开QGIS菜单“处理 → Python控制台”粘贴以下代码from qgis.core import QgsPalLayerSettings, QgsTextFormat, QgsVectorLayerSimpleLabeling layer iface.activeLayer() field_name 地块编号 # 检查字段是否存在 if layer.fields().indexFromName(field_name) -1: print(字段不存在请检查字段名 field_name) else: settings QgsPalLayerSettings() settings.fieldName field_name fmt QgsTextFormat() settings.setFormat(fmt) labeling QgsVectorLayerSimpleLabeling(settings) layer.setLabeling(labeling) layer.setLabelsEnabled(True) layer.triggerRepaint() print(标注已生成 layer.name())这段代码的逻辑和快速标注按钮完全一致创建一个标注设置对象指定字段启用标注刷新画布。你只要改掉第三行的字段名选中目标图层运行代码就行。如果想批量处理多个图层可以在代码外面包一层循环遍历图层面板里所有图层按图层名匹配字段名。比如for layer in QgsProject.instance().mapLayers().values(): if layer.type() QgsMapLayer.VectorLayer and layer.geometryType() QgsWkbType.PolygonGeometry: if layer.fields().indexFromName(地块编号) ! -1: # 这里复用上面的标注设置逻辑 settings QgsPalLayerSettings() settings.fieldName 地块编号 layer.setLabeling(QgsVectorLayerSimpleLabeling(settings)) layer.setLabelsEnabled(True)这个脚本会把所有面图层里含有“地块编号”字段的图层统一加上标注。涉及“字段不存在”的场景我会加个判断避免报错中断。4.3 出图前把标注转成注记手动微调的最后一步自动标注再智能总有想手动挪一下的时候。比如某个地名和符号重叠位置怎么调都有冲突这时候最直接的办法是把自动标注转成注记Annotation然后手工拖动文字位置。QGIS里有一个操作可以把当前图层的标注转成注记菜单位置不同版本略有差异一般在“图层”菜单或标注工具栏里能找到“将标注转换为注记”或“将标注转换为要素”。执行以后原来由标注引擎自动计算的文字会变成画布上一堆独立的注记对象可以点选、拖动、改字、删除。把标注转成注记之前我强烈建议先把当前配置保存一份.qml备份。因为转完以后标注就和图层样式脱钩了想重新自动排布就得加载备份样式。转换以后每个注记都可以单独选中文本框的位置可以随意调用的还是“移动要素”或“选择要素”那一套工具。这种手动微调在送审图里特别常用审图专家不会管你是不是自动生成的他们只关心文字有没有压到边界线、有没有压到重要地物。4.4 我的个人心得什么时候别用快速标注写了这么多最后说点反话快速标注按钮不是万能的有些场景我不建议用。第一种场景是严格按国标或行业规范出图。规范和模板通常规定字体字高、标注位置、压盖规则靠快速标注的默认设置很难一步到位还是要回到“图层标注设置”里逐项调。第二种场景是要素特别密集的区域。比如城市级路网每条道路都要标路名自动避让算法在这种密度下会很吃力标注可能大面积隐藏或乱跑。这种情况下我一般把标注转为注记手动挑重要道路标或者用“规则标注”按道路等级分别配置。第三种场景是标注内容非常复杂混入了图片、特殊符号、注记框线。这类需求已经超出“标注”本身建议直接用QGIS的“手绘注记”工具或者通过打印布局里的文本框完成。说这些不是劝你弃用快速标注。恰恰相反我几乎每天都会用它——出方案初稿、快速对数据、临时给同事演示它都是效率利器。只是心里要有个判断什么时候快是第一需求什么时候精细是第一需求。快速标注负责前者图层标注设置负责后者两者配合才是在QGIS里玩转标注的完整状态。回到标题那节课的核心快速标注按钮就是QGIS标注体系中那个最容易被忽视、却最实用的入口。它把“选中图层、选个字段、看到标注”压缩成了一次点击把这个入口用熟再往下的避让、表达式、样式管理就都有了一个顺手的起点。希望对刚接触QGIS的朋友有帮助也欢迎和我交流你在标注里遇到的奇葩问题。
