Gaea Editor 常见问题解决方案

项目基础介绍

Gaea Editor 是一个智能的网页设计工具，允许开发者在浏览器中设计网站。该项目主要使用 TypeScript 和 React 进行开发，旨在帮助开发者构建可扩展的网站可视化构建器。

新手使用注意事项及解决方案

1. 环境要求不满足

问题描述：新手在安装 Gaea Editor 时，可能会遇到 Node.js 版本不满足要求的问题。Gaea Editor 要求 Node.js 版本大于 8.0。

解决步骤：

1. 检查当前 Node.js 版本：在终端中运行 node -v。
2. 如果版本低于 8.0，建议使用 Node Version Manager (NVM) 安装或切换到合适的版本。
3. 安装 NVM：在终端中运行 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash。
4. 使用 NVM 安装 Node.js 8.0 或更高版本：运行 nvm install 8.0。
5. 切换到新安装的 Node.js 版本：运行 nvm use 8.0。

2. TypeScript 版本不匹配

问题描述：Gaea Editor 要求 TypeScript 版本为 3.0 或更高。如果本地 TypeScript 版本过低，可能会导致编译错误。

解决步骤：

1. 检查当前 TypeScript 版本：在终端中运行 tsc -v。
2. 如果版本低于 3.0，建议更新 TypeScript。
3. 使用 npm 更新 TypeScript：运行 npm install -g typescript@3.0。
4. 确认更新成功：再次运行 tsc -v，确保版本为 3.0 或更高。

3. 自定义组件添加失败

问题描述：新手在尝试添加自定义组件到拖拽菜单时，可能会遇到组件无法正确显示或功能异常的问题。

解决步骤：

1. 确保自定义组件符合 Gaea Editor 的要求，特别是 isContainer 属性的设置。
2. 检查自定义组件的代码，确保没有语法错误或逻辑错误。
3. 在 Gaea Editor 的配置中，正确引入自定义组件，并确保组件类名正确。
4. 示例代码：

   import BasicComponents from 'gaea-basic-components';
   import CustomComponent1 from './CustomComponent1';
   import CustomComponent2 from './CustomComponent2';
   
   <Editor componentClasses={[
       BasicComponents,
       CustomComponent1,
       CustomComponent2
   ]} />
   

5. 如果问题依旧存在，建议查看 Gaea Editor 的官方文档或社区论坛，寻找类似问题的解决方案。

通过以上步骤，新手可以更好地理解和使用 Gaea Editor，避免常见问题的困扰。