Cherry Markdown 本地开发环境搭建指南

环境准备

搭建Cherry Markdown的本地开发环境需要确保系统已安装Node.js环境。建议使用较新版本的Node.js（14.x或更高版本）以获得最佳兼容性。

安装依赖

项目提供了两种包管理工具的支持：

1. 使用npm安装：

npm install

2. 使用yarn安装（推荐）：

yarn install

构建流程

完整的本地开发构建流程包含以下步骤：

1. 清理构建目录：

npm run clean
# 或
yarn clean

2. 启动开发服务器：

npm run dev
# 或
yarn dev

开发模式说明

在开发模式下，系统会：

• 自动监视文件变化
• 实时编译SCSS为CSS
• 将字体文件复制到dist目录
• 提供热更新功能，修改文件后浏览器会自动刷新

示例运行

要查看项目示例，可执行：

npm run examples
# 或
yarn examples

访问时需注意：

• 直接访问localhost:3000会重定向到示例页面
• 推荐使用localhost:3000/examples/路径访问
• 避免直接访问index.html文件路径，可能导致资源加载异常

常见问题解决

1. JS文件未生成问题：

   • 确保使用yarn而非npm安装依赖
   • 检查控制台是否有报错信息
   • 确认node_modules已完整安装

2. 示例页面空白问题：

   • 确认访问路径是否正确
   • 检查浏览器控制台是否有404错误
   • 尝试清除浏览器缓存后重新加载

开发建议

1. 对于JavaScript开发，建议结合浏览器的开发者工具进行调试
2. 修改SCSS文件后，系统会自动重新编译，无需手动操作
3. 开发过程中如遇异常，可尝试重新运行clean命令后再启动dev

通过以上步骤，开发者可以建立一个完整的Cherry Markdown本地开发环境，实现代码修改的实时预览效果。