1. 环境准备与插件安装
第一次接触BlenderGIS时，我也被各种报错折腾得够呛。这里分享一个零失败的安装方案，特别适合Windows系统用户。首先去Blender官网下载最新稳定版（目前是3.6 LTS），建议选便携版(zip)而非安装版，这样后续配置环境变量更方便。
安装BlenderGIS插件有个小技巧：不要直接从GitHub下载压缩包，而是通过Blender内置的"Edit > Preferences > Add-ons"界面，点击右上角"Install..."按钮，输入这个直链地址：
https://github.com/domlysz/BlenderGIS/archive/refs/heads/master.zip这能避免手动解压可能出现的路径错误。勾选插件后别急着关闭窗口，继续安装两个必备辅助插件：
- Node Wrangler（节点操作神器）
- IO Viewer（数据预览工具）
安装完成后你会遇到第一个拦路虎——"No imaging library"报错。这是因为缺少地理数据处理库，解决方法比想象中简单：打开Blender安装目录下的\3.6\python\bin文件夹，在这里右键打开命令行（注意要用管理员权限），依次执行：
python -m ensurepip python -m pip install --upgrade pip python -m pip install numpy pillow gdal这套组合拳能一次性解决90%的环境依赖问题。如果遇到网络超时，可以添加清华镜像源参数：
--index-url https://pypi.tuna.tsinghua.edu.cn/simple2. OSM数据获取实战技巧
很多教程只教基础操作，但实际项目中数据质量才是关键。在BlenderGIS界面选择OSM数据源时，建议先做这三件事：
范围圈选策略：按住G键调出地图后，别急着框选整个区域。先用鼠标滚轮放大到能看到街道细节的级别（缩放等级建议18-20），然后按住Shift+鼠标中键平移视图，这样能避免下载过多无用数据。我做过测试：直接框选1平方公里区域会下载约50MB数据，而精细化选择建筑密集区只需3-5MB。
建筑类型过滤：点击"Get OSM"按钮前，一定要在过滤条件里勾选这些参数：
- building=yes（基础建筑轮廓）
- height=*（带高度信息的建筑）
- levels=*（有楼层数据的建筑）
这组筛选条件能过滤掉凉亭、工地围挡等非标准建筑。如果想做商业区仿真，可以额外添加：
"building"=["retail","commercial"] "shop"=*高程数据增强：在GIS菜单里有个隐藏功能——"Get DEM"。勾选NASA SRTM数据源，它能给建筑添加真实地形高度。记得把采样精度调到10m以内，否则建筑会漂浮在空中。这个步骤特别适合山地城市的建模需求。
3. 模型生成参数详解
点击生成按钮前，这几个参数设置直接影响成果质量：
建筑高度计算规则（实测最稳配置）：
- 优先采用
height字段原始值（单位：米） - 若无height字段，则按
levels字段×3米估算 - 两者都没有时，使用默认值15米（可通过
--default-height参数修改）
屋顶类型识别技巧：
# 在Python控制台输入这段代码可强制识别坡屋顶 import bpy bpy.context.scene.blendergis.auto_roof = True bpy.context.scene.blendergis.roof_angle = 30 # 坡度角度这个隐藏功能能自动将OSM中的roof:shape=*标签转换为真实3D结构，比如：
- gabled -> 双坡屋顶
- hipped -> 四坡屋顶
- flat -> 平屋顶
遇到复杂建筑群时，建议开启批量生成模式：
- 在Outliner面板全选所有建筑轮廓
- 按Ctrl+Shift+Alt+G组合键调出高级设置
- 勾选"Batch Processing"和"Preserve UVs"
- 设置线程数=CPU核心数-1（避免卡死）
4. 模型优化与导出
原始生成的模型通常存在两个问题：面数爆炸和UV错乱。这里分享我的三步优化法：
减面处理（保持外观的前提下）：
import bpy for obj in bpy.context.selected_objects: bpy.ops.object.modifier_add(type='DECIMATE') obj.modifiers["Decimate"].ratio = 0.3 # 保留30%面数 bpy.ops.object.modifier_apply(modifier="Decimate")这个脚本能把模型面数降到原来的1/3，对校园这类大场景特别有用。
UV修复方案：
- 全选所有建筑
- 按U键选择"Smart UV Project"
- 设置参数：
- Island Margin=0.01
- Angle Limit=30
- Area Weight=0.8
FBX导出避坑指南：
- 勾选"Apply Modifiers"
- 取消勾选"Embed Textures"
- 轴向选择Y-up（兼容3ds Max）
- 缩放系数设为0.01（解决单位制差异）
在3ds Max中导入后如果发现材质丢失，试试这个补救措施：在Blender的Shader Editor里，把所有Principled BSDF节点的材质名称改为"Material_[序号]"，然后重新导出。这个命名规则能被3ds Max正确识别。
5. 常见问题解决方案
Q1：建筑贴图全是纯色怎么办？A：这是OSM数据特性导致的，可以安装Maps2Blender插件补充真实影像：
- 在GIS菜单选择"Basemap"
- 选择ArcGIS卫星影像图层
- 设置分辨率≤2048px
- 点击"Georef Render"生成底图
Q2：生成的建筑全是悬空的？A：需要同步下载地形数据：
bpy.ops.importgis.georaster( dem_source='SRTM', clip_to_extent=True, resolution=10 )然后全选所有建筑，按Ctrl+P选择"Object"绑定到地形。
Q3：导入3ds Max后比例异常？A：这是单位制不匹配导致的，有两个解决方案：
- 在Blender导出时设置Scale=0.01
- 或者在3ds Max导入时选择"Rescale"选项
有个冷知识：按住Alt键点击BlenderGIS的按钮，会显示高级参数面板。比如在"Get OSM"界面这样操作，可以调出建筑立面细节生成选项，能自动添加窗户和门洞结构。
