android studio的vector asset studio对svg支持有限，需手动清理svg（删、拆内联样式、转transform为android属性）、用svg2vectordrawable工具转换，并显式设置width/height、viewport及fillcolor以确保兼容性和着色功能。
Android Studio 自带的 Vector Asset Studio 转换失败怎么办
很多 SVG 文件用 Android Studio 的 Vector Asset Studio 导入时直接报错或图形错位，根本不是工具不行，而是它对 SVG 的支持非常有限：只认最基础的 <path></path>、<group></group> 和简单 fill/stroke，遇到 <defs></defs>、<use></use>、渐变、滤镜、非整数坐标或嵌套 transform 就会静默丢弃或崩溃。
实操建议：
- 先用浏览器打开 SVG，确认能否正常渲染——不能渲染的，Android 几乎肯定转不了
- 用在线工具如 SVGOMG 点击
Clean up，关掉Remove hidden elements（否则可能删掉<defs></defs>里被引用的内容） - 手动删掉所有
<style></style>块，把内联style="fill:#xxx"拆成独立fill="#xxx"属性 - 把
transform="translate(10.5, 20)"改成android:translateX="10.5" android:translateY="20"—— Vector Drawable 不支持复合 transform 字符串
命令行批量转换：使用 svg2vectordrawable 工具
官方没提供 CLI，但社区维护的 svg2vectordrawable（GitHub 上同名项目）是目前最稳定的离线转换器，支持大部分 SVG 1.1 特性，且能输出带 android:tint 和 android:alpha 的可编辑 XML。
常见错误现象：java.lang.NoClassDefFoundError: org/w3c/dom/svg/SVGDocument —— 这是因为它依赖 Batik，而 Android Studio 自带的 JDK 17+ 默认不带 XML Graphics 库。
实操建议：
- 下载带完整依赖的 jar 包（不是仅源码），运行命令：
java -jar svg2vectordrawable.jar -i input.svg -o res/drawable/ic_logo.xml - 若提示
Unsupported element: <lineargradient></lineargradient>，说明该 SVG 用了渐变——Vector Drawable 只支持<gradient></gradient>且必须写在<path></path>外层，需手动提取并重写 - 转换后检查
android:viewportWidth和android:viewportHeight是否与原始 SVG 的viewBox一致，不一致会导致缩放变形
手写 Vector Drawable XML 时最容易漏的三个属性
很多人以为只要 <pathdata></pathdata> 对了就行，结果图标在不同屏幕密度上模糊、偏移或颜色异常，问题往往出在三个默认值上。
使用场景：适配深色模式、动态着色、或需要精确对齐文字的 TextView 复合 drawable。
实操建议：
- 必须显式写
android:width="24dp"和android:height="24dp"—— 不写会按 viewport 等比缩放，但 dp 单位丢失，导致高密度屏下糊 - 必须设
android:viewportWidth和android:viewportHeight与原始 SVG 的viewBox完全一致（例如"100.0" "100.0"），否则pathData坐标系错乱 - 如果要支持 tint，得给
<path></path>加android:fillColor="@android:color/transparent"，再靠父控件的tint属性控制颜色；不加这句，tint 无效
Gradle 构建时报错 AAPT: error: not well-formed (invalid token)
这个错误几乎全是 XML 语法问题，但 AAPT 报错位置经常不准，实际根源常在 <pathdata></pathdata> 里的空格、逗号或转义字符。
性能影响：这类错误会让构建卡在 aapt2 阶段，且不会给出具体哪一行，排查成本远高于预防。
实操建议：
- 把
<pathdata></pathdata>内容粘贴到 regex101，用正则[^\x20-\x7E\t\n\r]扫描不可见字符（尤其是 Windows 复制带来的 \u200e 零宽空格） - 确保所有逗号前后**没有空格**（
M 10,20 L 30,40✅，M 10 , 20 L 30 , 40❌） - 路径末尾不要有多余换行或空格，
<pathdata>M10,10Z</pathdata>比<pathdata>M10,10Z\n</pathdata>更安全
真正麻烦的从来不是怎么转，而是 SVG 里那些“看起来没问题”的小细节——比如一个没闭合的 <path></path>，在浏览器里自动补全了，Vector Drawable 却直接忽略整条路径。
