萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android XML 錯誤:Error parsing XML: unbound prefix 解決方法

編寫 XML 資源檔(如 Preference、Layout、Menu)時,常遇 「Error parsing XML: unbound prefix」 錯誤,根因是根元素缺少命名空間宣告。

錯誤重現

<PreferenceScreen>
    <CheckBoxPreference android:key="sync" android:title="同步" />
</PreferenceScreen>

報錯:unbound prefix 指 android: 前綴未綁定命名空間。

修正方法

在根元素添加 xmlns:android 宣告:

<PreferenceScreen xmlns:android="https://schemas.android.com/apk/res/android">
    <CheckBoxPreference android:key="sync" android:title="同步" />
</PreferenceScreen>

原理解析

  • XML 命名空間機制:xmlns:prefix="URI" 將前綴綁定至 URI;
  • Android 所有屬性(android:layout_width、android:id 等)均屬 https://schemas.android.com/apk/res/android 命名空間;
  • 根元素未宣告 → 解析器無法解析前綴 → 拋出 unbound prefix。

適用場景

  • 所有 XML 資源檔:layout/、menu/、xml/(Preference)、values/ 等;
  • 自定義屬性時亦需在根元素宣告 xmlns:app="https://schemas.android.com/apk/res-auto"。
copyright © 萬盛學電腦網 all rights reserved