Modern.js 项目创建工具 @modern-js/create 使用指南

Modern.js 是一个现代化的前端开发框架，它提供了一套完整的工具链来简化前端开发流程。其中 @modern-js/create 是 Modern.js 提供的项目脚手架工具，可以帮助开发者快速创建不同类型的项目模板。

环境准备

在使用 @modern-js/create 创建项目前，请确保你的开发环境满足以下要求：

• Node.js 版本 14 或更高版本（推荐使用 LTS 版本）
• 包管理器（npm、yarn 或 pnpm）
• 代码编辑器（如 VSCode）

工具安装与使用

@modern-js/create 采用了无需全局安装的设计理念，你可以直接通过 npx 命令运行最新版本：

npx @modern-js/create@latest [项目目录名]

如果省略项目目录名参数，工具会在当前目录下创建项目。

项目创建流程

运行命令后，工具会通过交互式命令行引导你完成项目创建。下面介绍两种常见项目类型的创建过程。

创建 Web 应用项目

执行以下命令创建 Web 应用：

npx @modern-js/create@latest web-app

工具会依次询问以下配置选项：

1. 项目类型：选择 "Web App"
2. 编程语言：支持 TypeScript(TS) 或 JavaScript(JS)
3. 包管理器：可选择 npm、yarn 或 pnpm
4. 打包工具：支持 webpack 或 esbuild

创建 NPM 模块项目

执行以下命令创建 NPM 模块：

npx @modern-js/create@latest npm-module

工具会依次询问以下配置选项：

1. 项目类型：选择 "Npm Module"
2. 项目名称：输入你的模块名称
3. 编程语言：支持 TypeScript(TS) 或 JavaScript(JS)
4. 包管理器：可选择 npm、yarn 或 pnpm

项目模板特性

Modern.js 提供的项目模板具有以下优势：

1. 开箱即用：内置了现代化的开发配置，无需从零开始搭建
2. 最佳实践：遵循行业最佳实践的项目结构
3. 多场景支持：支持 Web 应用、NPM 模块等多种项目类型
4. 灵活配置：提供多种选项满足不同项目需求

常见问题解答

Q: 为什么推荐使用 npx 而不是全局安装？

A: 使用 npx 可以确保每次运行的都是最新版本的工具，避免了全局安装可能带来的版本管理问题。

Q: 创建项目后如何启动开发服务器？

A: 对于 Web 应用项目，进入项目目录后运行 pnpm run dev（根据你选择的包管理器调整命令）即可启动开发服务器。

Q: 能否在已有项目中使用 Modern.js？

A: Modern.js 提供了渐进式集成方案，但推荐使用 @modern-js/create 创建新项目以获得最佳体验。

通过 @modern-js/create 工具，开发者可以快速启动 Modern.js 项目，专注于业务逻辑开发而非环境配置，大幅提升开发效率。