Android Studio的Vector Asset Studio对SVG支持有限，需手动清理SVG（删<style>、拆内联样式、转transform为android属性）、用svg2vectordrawable工具转换，并显式设置width/height、viewport及fillColor以确保兼容性和着色功能。
Android Studio 自带的 Vector Asset Studio 转换失败怎么办
很多 SVG 文件用 Android Studio 的 Vector Asset Studio 导入时直接报错或图形错位，根本不是工具不行，而是它对 SVG 的支持非常有限：只认最基础的 <path>、<group> 和简单 fill/stroke，遇到 <defs>、<use>、渐变、滤镜、非整数坐标或嵌套 transform 就会静默丢弃或崩溃。
实操建议：
- 先用浏览器打开 SVG，确认能否正常渲染——不能渲染的，Android 几乎肯定转不了
- 用在线工具如 SVGOMG 点击
Clean up，关掉Remove hidden elements（否则可能删掉<defs>里被引用的内容） - 手动删掉所有
<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>，说明该 SVG 用了渐变——Vector Drawable 只支持<gradient>且必须写在<path>外层，需手动提取并重写 - 转换后检查
android:viewportWidth和android:viewportHeight是否与原始 SVG 的viewBox一致，不一致会导致缩放变形
手写 Vector Drawable XML 时最容易漏的三个属性
很多人以为只要 <pathData> 对了就行，结果图标在不同屏幕密度上模糊、偏移或颜色异常，问题往往出在三个默认值上。
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
使用场景：适配深色模式、动态着色、或需要精确对齐文字的 TextView 复合 drawable。
实操建议：
- 必须显式写
android:width="24dp"和android:height="24dp"—— 不写会按 viewport 等比缩放，但 dp 单位丢失，导致高密度屏下糊 - 必须设
android:viewportWidth和android:viewportHeight与原始 SVG 的viewBox完全一致（例如"100.0" "100.0"），否则pathData坐标系错乱 - 如果要支持 tint，得给
<path>加android:fillColor="@android:color/transparent"，再靠父控件的tint属性控制颜色；不加这句，tint 无效
Gradle 构建时报错 AAPT: error: not well-formed (invalid token)
这个错误几乎全是 XML 语法问题，但 AAPT 报错位置经常不准，实际根源常在 <pathData> 里的空格、逗号或转义字符。
性能影响：这类错误会让构建卡在 aapt2 阶段，且不会给出具体哪一行，排查成本远高于预防。
实操建议：
- 把
<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>，在浏览器里自动补全了，Vector Drawable 却直接忽略整条路径。
