对熟悉的朋友来说,这应该不是个事儿。不就是个 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
,这里存放着项目的启动方式、生产和开发依赖。
哈哈 果然,
dev
是用来启动开发服务器的,build
是构建生产环境的应用,start
是启动构建好的生产应用,lint
是运行代码检查。
scripts
部分是一个映射,前边的字段要加上npm run
,运行后,就会实际执行对应的next
命令。
让我们用 npm run dev
运行开发服务器(点调试也可以,但不推荐,会慢一些):
进来了:
不过会发现加载特别慢,导航到其他路径也是一样,能感觉到明显的延迟。我们看看日志:
可以看到每个路径的编译都花了很长时间,涉及 1700 多个模块。这是因为处于开发模式,且首次加载。
如果路径已经加载过一次,然后我们再切回来,就会快很多:
或者我们直接构建生产版本(npm run build
),然后运行(npm run start
):
如果遇到端口冲突,就在 package.json
中自定义一个其他端口的启动脚本,像这样:
"start:3001": "next start -p 3001",
重新启动:
看看效果:
不错,除了一些按钮本身就无法点击外(没有配置路由),还是非常流畅的!