3步解决psd2fgui转换难题

3步解决psd2fgui转换难题

【免费下载链接】psd2fguiA tool for converting psd file to fairygui package.项目地址: https://gitcode.com/gh_mirrors/ps/psd2fgui

场景一：PSD导入无响应怎么办？

场景描述：运行转换命令后无任何反应
排查流程图：

1. 🔍检查Node.js是否安装（输入node -v查看版本）
2. 🛠️执行npm install # 安装依赖包（项目运行所需的辅助文件）
3. 🛠️运行node convert ./test/test.psd # 转换测试文件
   预防措施：
   💡定期执行npm update保持依赖包最新【适用v1.0.0+】

场景二：转换后图层显示异常？

场景描述：PSD文件能转换但图层错位
排查流程图：

1. 🔍检查图层名是否含中文/特殊符号？
2. 🛠️重命名图层为纯英文（如"btn_home"）
3. 🛠️简化PSD结构，合并隐藏无用图层
   预防措施：
   💡建立图层命名规范文档【适用所有版本】

场景三：命令行报红错误码？

场景描述：终端显示Error开头的错误信息
排查流程图：

1. 🔍复制错误码到项目Issues搜索解决方案
2. 🛠️删除node_modules文件夹后重新安装依赖
3. 🛠️使用node convert --debug ./test/test.psd获取详细日志
   预防措施：
   💡执行转换前先运行npm run check # 检查环境完整性【适用v1.2.0+】

附录：常见错误代码速查表

环境准备指南

🛠️克隆项目：git clone https://gitcode.com/gh_mirrors/ps/psd2fgui
🛠️进入目录：cd psd2fgui
🛠️安装依赖：npm install # 安装项目所需的辅助文件

快速启动步骤

1. 将PSD文件放入./test目录
2. 执行转换命令：node convert ./test/你的文件.psd
3. 查看输出目录获取fairygui包文件

💡小技巧：创建convert.bat批处理文件保存常用命令，双击即可快速执行转换操作。

【免费下载链接】psd2fguiA tool for converting psd file to fairygui package.项目地址: https://gitcode.com/gh_mirrors/ps/psd2fgui