XML 中的命名空间如何使用?

封面图 • 2026-01-16 • .NET

在 XML（可扩展标记语言）中，**命名空间（Namespace）** 用于避免元素名称冲突。当多个 XML 文档或 XML 模式（Schema）使用相同名称的元素时，命名空间可以帮助区分它们。

---

## 一、命名空间的基本概念

XML 命名空间是一个由 URI（统一资源标识符）定义的“命名空间”或“范围”。它不是 URL，而是用来唯一标识一组名称的字符串。

例如：

```xml
http://www.example.com/myNamespace
```

---

## 二、如何声明命名空间？

在 XML 中，可以通过 `xmlns` 属性来声明命名空间。

### 1. 默认命名空间（没有前缀）

```xml
<root xmlns="http://www.example.com/myNamespace">
    <element>内容</element>
</root>
```

在这个例子中，`<element>` 元素属于 `http://www.example.com/myNamespace` 命名空间。

### 2. 带前缀的命名空间

```xml
<root xmlns:ex="http://www.example.com/myNamespace">
    <ex:element>内容</ex:element>
</root>
```

这里，`ex` 是命名空间的前缀，表示 `<ex:element>` 属于该命名空间。

---

## 三、命名空间的作用

### 1. 避免元素名称冲突

比如两个不同的 XML 文档都使用了 `<title>` 元素，但分别属于不同的命名空间：

- 文档 A：`<book:title>...</book:title>`
- 文档 B：`<article:title>...</article:title>`

通过命名空间可以区分这两个 `<title>` 元素。

### 2. 与 XML Schema（XSD）结合使用

XML Schema 通常会使用命名空间来定义元素和属性的结构。例如：

```xml
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="http://www.example.com/myNamespace">
    <xs:element name="person" type="xs:string"/>
</xs:schema>
```

---

## 四、示例：完整的 XML 示例

```xml
<?xml version="1.0" encoding="UTF-8"?>
<root xmlns:ex="http://www.example.com/myNamespace">
    <ex:element>这是命名空间中的元素</ex:element>
</root>
```

---

## 五、命名空间的注意事项

| 项目 | 说明 |
|------|------|
| URI 不需要是有效的 URL | 只要它是唯一的即可，不一定要能访问 |
| 前缀可以任意命名 | 但建议有意义，如 `ex`, `ns`, `my` 等 |
| 命名空间是“作用域”的概念 | 它不会影响数据内容，只是帮助解析器识别元素所属的“集合” |

---

## 六、命名空间的常见问题

### Q: 为什么我不能直接用 `xmlns="..."` 来引用外部 schema？

A: 你需要使用 `xsi:schemaLocation` 或者 `schemaLocation` 属性来关联 schema 和 XML 文件。

```xml
<root xmlns="http://www.example.com/ns"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.example.com/ns mySchema.xsd">
    ...
</root>
```

---

## 七、总结

| 语法 | 说明 |
|------|------|
| `xmlns="URI"` | 声明默认命名空间 |
| `xmlns:prefix="URI"` | 声明带前缀的命名空间 |
| `prefix:element` | 使用带前缀的元素 |

命名空间是 XML 中组织和管理元素的重要机制，尤其在处理复杂、多来源的 XML 数据时非常关键。

如果你有具体的 XML 示例或想了解命名空间在特定场景（如 SOAP、SVG、HTML5 等）中的应用，欢迎继续提问！