Remax CLI 命令行工具使用指南

Remax CLI 命令行工具使用指南

remax 使用真正的 React 构建跨平台小程序 项目地址: https://gitcode.com/gh_mirrors/re/remax

概述

Remax 是一个基于 React 的小程序开发框架，其 CLI（命令行界面）工具提供了强大的项目构建能力。本文将详细介绍 Remax CLI 的各项功能和使用方法，帮助开发者高效地进行小程序开发。

基本构建命令

remax build 是 Remax 最核心的命令，用于编译项目并生成构建产物。构建结果默认存放在 dist/${target} 目录下。

remax build

常用参数详解

目标平台选择 (-t/--target)

Remax 支持多平台小程序开发，通过 --target 参数指定目标平台：

• ali：支付宝小程序
• toutiao：头条小程序
• wechat：微信小程序
• web：Web 浏览器应用

示例：

remax build -t wechat

监听模式 (-w/--watch)

开发过程中，使用监听模式可以实时响应文件变更并重新构建：

remax build -w

此模式会显著提升开发效率，建议在开发阶段始终开启。

错误通知 (--notify)

启用错误通知功能后，构建失败时会推送系统消息提醒开发者：

remax build --notify

端口指定 (-p/--port)

当构建 Web 应用时，可以指定开发服务器端口：

remax build -t web -p 3001

高级构建选项

代码压缩 (-m/--minimize)

默认情况下，监听模式不会压缩代码以保证构建速度。如需在开发阶段进行真机调试，可以开启压缩：

remax build -w -m

注意事项：

1. 压缩会增加构建时间
2. 在微信小程序平台使用时，需在开发者工具中关闭"上传代码压缩混淆"选项，避免双重压缩导致语法解析错误

构建分析 (--analyze)

开启构建分析功能可以可视化查看打包结果中各模块的大小和依赖关系：

remax build --analyze

这对于优化项目体积非常有帮助，可以快速定位体积过大的模块。

React 调试工具 (--devtools)

Remax 默认开启 React 开发者工具支持，如需关闭可使用：

remax build --no-devtools

日志级别控制 (--loglevel)

Remax 提供了灵活的日志级别控制，可根据需求调整：

• debug：最详细级别，包含运行时详细信息
• verbose/info：常规详细信息
• warn：仅显示警告
• error：仅显示错误
• silent：静默模式（不显示任何信息）

示例：

remax build --loglevel warn

最佳实践建议

1. 开发阶段建议组合使用 -w 和 --notify 参数
2. 生产构建时建议添加 -m 参数以获得最小化代码
3. 遇到性能问题时使用 --analyze 分析构建结果
4. 调试复杂问题时可将日志级别设为 debug

通过合理使用这些命令行参数，可以显著提升 Remax 项目的开发效率和构建质量。

remax 使用真正的 React 构建跨平台小程序 项目地址: https://gitcode.com/gh_mirrors/re/remax