因xml列是整体类型，不支持隐式转换或直接比较；必须用.nodes()摊平为行集，再通过cross apply关联，否则无法参与join或where操作。
为什么直接 JOIN XML 列会失败
XML 列不能像普通字符串或数值列那样参与 JOIN 或 WHERE 比较。SQL Server 把它当做一个整体类型，不支持隐式转换，也不允许用 = 或 LIKE 直接匹配内容。你写 WHERE xml_col = '<a>1</a>' 会报错，哪怕内容完全一致。
真正能“进入 XML 内部”的入口只有四个方法：.value()、.query()、.nodes()、.exist()。其中 .nodes() 是唯一能把 XML “摊平”成行集的工具，也是后续做关联查询的前提。
CROSS APPLY + nodes() 的固定写法模板
CROSS APPLY 不是可选语法糖，它是强制要求：没有它，.nodes() 返回的虚拟表根本无法被 SELECT 引用。常见错误是漏掉 AS T(c) 别名，或把路径写成变量但没加引号。
-
.nodes()的 XPath 路径必须返回元素节点集合，不能是文本节点或属性节点（比如/book/title/text()会报错；得写成/book/title） - 路径区分大小写，
/Book/Author和/book/author是两个不同路径 - 若某条记录的 XML 中没有匹配节点，
CROSS APPLY会直接过滤掉该行（类似INNER JOIN）；需要保留原行时改用OUTER APPLY - 别名
T(c)中的c是后续.value()的上下文节点，不是列名——T.c.value()才对，写成T.value()会报错
标准结构长这样：
SELECT
t.c.value('(./name/text())[1]', 'NVARCHAR(50)') AS name,
t.c.value('(./price/text())[1]', 'DECIMAL(10,2)') AS price
FROM orders o
CROSS APPLY o.details.nodes('/order/items/item') AS t(c);
提取值时 value() 总返回 NULL？检查这几点
.value() 对路径和类型极其敏感，返回 NULL 几乎总是因为路径没命中，而不是数据为空。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 忘了加
[1]：XPath 如name可能匹配多个同名节点，必须用(name/text())[1]显式取第一个文本值 - 路径层级错：XML 是
<root><data><item><id>1</id></item></data></root>，但写了/item/id—— 正确应为/root/data/item/id或更健壮的//item/id - 属性漏
@：取id="123"要写@id[1]，不是id[1] - 类型强转失败：用
'INT'去转空字符串或含空格的文本，直接返回NULL；建议先用TRY_CAST(... AS INT)包一层
安全写法示例：
SELECT
TRY_CAST(t.c.value('(@seq)[1]', 'NVARCHAR(20)') AS INT) AS seq_id,
ISNULL(t.c.value('(title/text())[1]', 'NVARCHAR(100)'), '') AS title
FROM docs d
CROSS APPLY d.content.nodes('/document/section') AS t(c);
如何让 XML 关联外部表（比如查用户+其配置项）
核心是把 CROSS APPLY 当作“左表每行调用一次 XML 展开”，再在 SELECT 或 WHERE 中引用左表字段。常见场景是主表带 XML 配置，要按配置里的某个值筛选或关联。
- 在
WHERE中用.exist()做存在性过滤比展开更快，例如：WHERE config.exist('/setting[@name="theme" and text()="dark"]') = 1 - 若需精确匹配 XML 中的值与另一张表字段（如
user.id = config.value('(./userId)[1]', 'INT')），必须确保.value()路径有效且类型一致，否则整个JOIN条件失效 - 避免在
ON子句里直接写xml_col.nodes()—— 必须先CROSS APPLY展开，再在JOIN条件中使用展开后的别名
典型多层关联写法：
SELECT u.name, c.setting_name, c.value
FROM users u
CROSS APPLY u.preferences.nodes('/prefs/entry') AS p(x)
CROSS APPLY (
SELECT
p.x.value('(@key)[1]', 'NVARCHAR(50)') AS setting_name,
p.x.value('(text())[1]', 'NVARCHAR(200)') AS value
) c
WHERE c.setting_name = 'language';
最易忽略的是：XPath 中的 > 和 必须写成 <code>> 和 实体编码，SQL Server 不接受裸符号——哪怕你在字符串里拼接也一样。这个错不会报语法异常，而是让 <code>.exist() 或 .value() 静默返回 NULL。
