在构建 Android 应用时，可能会遇到类似以下的编译失败提示：

Execution failed for task ':app:mergeDebugResources'
A failure occurred while executing com.android.build.gradle.internal.res.ResourceCompilerRunnable
Resource compilation failed. Cause: java.nio.file.InvalidPathException: Illegal char <:> at index 49: com.example.app-mergeDebugResources-26:/values/values.xml

尽管错误信息提到了非法字符 :，但问题根源通常并非路径本身包含冒号，而是自定义资源属性与 Android 系统保留名称冲突，导致资源合并过程中生成了异常的内部路径标识。

问题分析

查看项目的 attrs.xml 文件，发现定义了一个名为 bgColor 的自定义属性：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="DirButtonStyle">
        <attr name="title" format="string"/>
        <attr name="values" format="string"/>
        <attr name="bgColor" format="color"/>
    </declare-styleable>
</resources>

其中，bgColor 和 values 是潜在的问题属性名。Android 系统内部已广泛使用如 background、value 等命名，直接使用 bgColor 可能引发命名空间冲突，尤其是在 Gradle 构建系统处理资源合并时，会将属性名用于构建临时资源路径（如错误中的 ...-mergeDebugResources-26:/...），从而触发 InvalidPathException。

解决方案

为了避免与系统属性名冲突，应为自定义属性添加唯一的前缀。推荐使用模块或功能相关的缩写作为命名空间前缀，例如 tab_ 或 dir_。

修改后的 attrs.xml 如下：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="DirButtonStyle">
        <attr name="tab_title" format="string"/>
        <attr name="tab_values" format="string"/>
        <attr name="tab_bgColor" format="color"/>
    </declare-styleable>
</resources>

同时，在布局文件中使用更新后的属性名：

<com.example.cardreader.view.DirButton
    android:id="@+id/tab2_dir_comminterface"
    android:layout_width="match_parent"
    android:layout_height="45dp"
    app:tab_bgColor="#f6ffff"
    app:tab_title="通信接口" />

确保所有引用该自定义 View 的布局均同步更新属性名。

总结

此类错误的根本原因并非文件路径含有非法字符，而是自定义资源属性命名不当引发的内部构建路径异常。通过为自定义属性添加唯一前缀（如 tab_、custom_ 等），可有效避免与 Android 系统属性的命名冲突，从而解决资源编译失败问题。