本地开发
本页介绍如何搭建本地开发环境。
环境要求
- Node.js 18.x 或更高版本
- npm 或 yarn
- Git
克隆项目
bash
git clone https://github.com/Zhang142857/wenyanwengongju.git
cd wenyanwengongju安装依赖
bash
npm install配置文件
复制配置模板：
bash
cp config.example.json config.json编辑 config.json，填入你的 API 配置（可选）。
开发命令
Web 开发模式
bash
npm run dev访问 http://localhost:3000
Electron 开发模式
bash
npm run electron:dev这会同时启动 Next.js 开发服务器和 Electron 窗口。
运行测试
bash
# 运行所有测试
npm test
# 监听模式
npm run test:watch
# 生成覆盖率报告
npm run test:coverage构建命令
构建 Web 版本
bash
npm run build构建 Electron 应用
bash
npm run electron:build构建 Windows 安装包
bash
npm run electron:build:win构建产物在 dist/ 目录。
开发工具
推荐的 VS Code 扩展
- ESLint
- Prettier
- TypeScript Vue Plugin
- CSS Modules
调试
在 Electron 开发模式下，可以使用 Chrome DevTools 调试：
- 主进程：使用 VS Code 调试
- 渲染进程：按 F12 打开 DevTools
常见问题
npm install 失败
尝试：
- 删除
node_modules和package-lock.json - 清除 npm 缓存：
npm cache clean --force - 重新安装：
npm install
Electron 启动失败
确保：
- Next.js 开发服务器已启动
- 端口 3000 没有被占用
- 依赖安装完整