Stylus Studio XML映射器是面向XSLT/XQuery开发者的强类型XML结构转换辅助环境，非通用ETL工具；默认生成XSLT 1.0，不支持JSON或数据库直连，常见问题包括命名空间未显式声明、xsi:type多态需手动配置条件映射、for-each循环中路径与作用域错误、空变量导致Saxon报错等。
为什么刚拖完字段就报 Cannot resolve source node
这是最常见阻塞点：Stylus Studio不会自动推断源XML的命名空间上下文，哪怕你的输入文件有 xmlns="http://example.com/ns"，映射器也当它不存在。
- 必须手动在
Source Schema视图右键 →Set Default Namespace...，粘贴实际命名空间URI - 若源XML用前缀（如
ns:book），需在映射画布顶部工具栏点击Namespaces按钮，显式声明前缀与URI映射 - 未设命名空间时，
//book路径能匹配，但/root/book会失败——因为根节点实际属于默认命名空间，而无前缀的路径表达式不进入默认命名空间
目标XSD含 xsi:type 多态时映射器不生成类型切换逻辑
Stylus Studio默认把 xsi:type 当普通属性处理，不会自动生成
- 在目标元素上右键 →
Insert Conditional Mapping...，选择xsi:type作为条件源 - 为每个预期类型（如
ns:Novel、ns:Essay）添加分支，并在分支内拖入对应子结构 - 注意：生成的XSLT中条件判断用的是
@xsi:type = 'ns:Novel'，但实际运行时需确保xsi前缀已在XSLT中声明（映射器通常漏掉这行：xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"），要手补
用 map:for-each 循环但输出只有首项
这是XSLT 1.0引擎限制被掩盖的结果。Stylus Studio的可视化循环组件底层调用 position()、last()）和嵌套上下文敏感：
- 检查循环内部是否误用了绝对路径（如
/root/item/name）——应改用相对路径（如name） - 若循环体里有另一个
map:for-each，外层的position()在内层不可见，需用变量暂存： - 避免在循环内直接写
导出的XSLT在Saxon-HE下运行报 XTTE0570: An empty sequence is not allowed as the value of variable $v
Stylus Studio生成的变量声明默认带 select=""，即使你没填值，也会输出空序列字面量。Saxon严格校验，而MSXML等老引擎容忍。
- 打开生成的XSLT，搜索
，删掉所有形如 select=""的属性（保留无select的变量，让其值为空序列） - 若变量本意是接收可选节点（如
as="xs:string?"类型标注（需XSLT 2.0+，此时应换用Stylus Studio的XSLT 2.0生成模式） - 更稳妥的做法：在映射器中右键变量 →
Properties→ 取消勾选Initialize with empty string
