快速上手 Vite、React、TypeScript、Tailwind 和 Node.js ESM 起点套件

本指南旨在提供一个简洁明了的流程，帮助您了解并使用基于 Vite、React、TypeScript、Tailwind CSS 的项目模板，并融入对 pn/pm 支持的现代前端开发环境。通过以下步骤，您可以轻松地设置项目、启动开发服务器以及理解核心API的使用方法。

安装指南

环境准备

确保您的开发环境已安装 Node.js。推荐版本为 Node.js 14 及以上，以便支持 ES 模块和最新的包管理器特性。

获取项目

1. 访问本项目的GitHub页面，点击“Use this template”按钮以创建新仓库。

2. 克隆到本地：

   git clone https://github.com/your-forked-repo-url.git
   

安装依赖

推荐使用 pn(pm)，但 npm 亦可。执行相应的命令来安装所有必要的依赖：

对于 pn.pm 用户：

pnpm install

若选择 npm：

npm install

请注意，在 macOS 上，可通过 Homebrew 安装 pn(pm)：

brew install pnpm

项目的使用说明

开发模式运行

快速启动开发服务器，实时编译和热重载：

pnpm dev

运行测试

确保代码质量符合标准：

pnpm test

构建生产环境应用

生成压缩过的生产环境代码：

pnpm build

项目API使用文档

本项目的API主要围绕React组件及配置文件进行。对于React和TypeScript的组合，组件应遵循TypeScript的类型定义，利用接口来定义props。Tailwind CSS的类可以直接在React元素的class属性中使用，无需额外配置。具体API细节需参考实际组件源码和Tailwind的官方文档进行深入学习。

高效开发技巧

• 使用 npm-run-all 并行运行任务以提升效率。
• 利用Prettier和ESLint的缓存机制减少等待时间。
• 推荐安装@ianvs/prettier-plugin-sort-imports自动排序导入语句。
• 对于Node脚本，采用swc配合ts-node加速TypeScript脚本处理，尤其适用于ESM模块。

ESM与TypeScript的Node脚本示例

创建一个名为script.ts的文件，并使其可执行：

#!/usr/bin/env node --no-warnings --experimental-specifier-resolution=node --loader ts-node/esm
console.log('该脚本使用ESM和TypeScript执行。');

通过赋予执行权限并运行，即可体验即时重启功能的脚本（需修改脚本来启用）：

chmod +x script.ts
./script.ts

在开发过程中，这些指令将引导您高效地搭建和管理项目。通过遵循上述步骤和建议，您将能够充分利用这个结合了前沿技术和最佳实践的开发起点套件。