导入 ZIP 压缩包快速开工

为什么要用 ZIP 导入

不想从零建工程、手上有现成的源码包——比如 GitHub 下载下来的某个开源项目、之前在电脑上写的自己的小工具——用 ZIP 导入是最快的方式：一次把整个目录结构和所有文件搬进来，不需要一个一个手动建。

操作步骤

第一步：把源码打成 ZIP

在电脑上，选中项目根目录下的所有文件和文件夹（不是选中父文件夹，避免多一层嵌套），压缩成 ZIP。命名建议和项目相关，方便在手机上识别。

第二步：在 WebCat 里触发导入

进入首页或工程列表的操作菜单，找到「导入」或「ZIP 导入」选项。部分版本的 WebCat 还会直接调用系统文件管理器来选文件（5.21 更新说明里提到的改进）。

第三步：选文件、等解压

在弹出的文件管理器里找到刚才打的 ZIP，点选后 WebCat 会自动解压到工程目录。解压完成后工程列表里就能看到新项目，直接进去开发即可。

导入时可能遇到的问题

① ZIP 里多嵌套了一层

有些压缩工具默认把父文件夹一起打包，解压后变成 project/project-root/ 这种嵌套结构。如果出现这种情况：

• 进入 WebCat 的文件管理，手动把内层文件夹的内容挪到根目录
• 或者在电脑上重新打包时，选中所有内容文件而不是父文件夹本身

② 中文文件名乱码

ZIP 内部的文件名编码格式导致。WebCat 一般能处理 UTF-8 编码的文件名，如果遇到 GBK 编码的旧压缩包可能出现乱码——在电脑上用 UTF-8 重新打包就能解决。

③ 大文件或复杂依赖的项目

超过几十 MB 的大型项目、或者带有复杂构建依赖（node_modules 等）的工程，解压后在 WebCat 里加载会比较慢——这是正常现象。WebCat 适合中小型项目的移动端开发，大型工程建议还是在电脑上操作为主，WebCat 用来做补充。

导入后第一件事：跑一次预览

解压完成后立刻打开 index.html 点运行，确认：

• CSS 能正常加载（样式没丢）
• JS 能正常执行
• 没有路径错误（图片资源、引用文件找不到）

如果预览白屏或样式错乱，大概率是 ZIP 嵌套或路径问题导致的，按上面的方法排查就行。