Tailwind Plus 模板,咋跑起来啊?

对熟悉的朋友来说,这应该不是个事儿。不就是个 Next.js + Tailwind CSS 项目嘛,照着一般流程走下去就是了。

但大家擅长的领域不同,不是所有人都了解 Next.js、Tailwind、React 这些前端技术栈。他们可能只是需要一个模板,然后简单的改改配置,然后快速对接、应用。

既然有人有这样的需求,那就有必要写一个帖子,作为参考、指引了。

我们以 Protocol 模板为例:

点击 Download,下载压缩包:

随便解压到一个目录(我这里放到了 下载 目录):

这里用的解压软件是 BandZip(推荐)。

可以看到这里分两个版本,一个 js 版,一个 ts 版,我们选择 ts 版。

Shift + 右键,通过 Windsurf(VS Code、Cursor 也行)打开:

这个时候,我们随便打开 components 目录下的一个 .tsx 文件(React 组件),会发现很多地方都飘红了,右下角的 Prettier 也是:

这是因为我们没有安装依赖(可以看到没有 node_modules 目录),从 Prettier 的报错信息也可以验证这一点:

["ERROR" - 17:32:47] Failed to load module. If you have prettier or plugins referenced in package.json, ensure you have run `npm install`
["ERROR" - 17:32:47] Cannot find module 'prettier' from 'c:\Users\24750\Downloads\tailwind-plus-protocol\protocol-ts'

打开 Windsurf 的终端,运行 npm install 安装依赖:

本机需要有 Node 环境,没有的话可以去 官网 装一个。

可以看到,组件和 Prettier 的错误消失了,然后多了一个 node_modules 目录(它就是专门存放依赖包的)。

那怎么在本地运行(预览)呢?

一般是 npm run dev,不过我们还是看看 package.json,这里存放着项目的启动方式、生产和开发依赖。

哈哈:smile: 果然,dev 是用来启动开发服务器的,build 是构建生产环境的应用,start 是启动构建好的生产应用,lint 是运行代码检查。

scripts 部分是一个映射,前边的字段要加上 npm run,运行后,就会实际执行对应的 next 命令。

让我们用 npm run dev 运行开发服务器(点调试也可以,但不推荐,会慢一些):

进来了:

不过会发现加载特别慢,导航到其他路径也是一样,能感觉到明显的延迟。我们看看日志:

可以看到每个路径的编译都花了很长时间,涉及 1700 多个模块。这是因为处于开发模式,且首次加载。

如果路径已经加载过一次,然后我们再切回来,就会快很多:

PixPin_2025-03-13_19-35-20

或者我们直接构建生产版本(npm run build),然后运行(npm run start):

如果遇到端口冲突,就在 package.json 中自定义一个其他端口的启动脚本,像这样:

"start:3001": "next start -p 3001",

重新启动:

看看效果:

PixPin_2025-03-13_19-43-47

不错,除了一些按钮本身就无法点击外(没有配置路由),还是非常流畅的!

1 个赞