开发服务器

Dev Server

前端工程也叫：本地服务、localhost、npm run dev、本地预览

一句话：在自己电脑上临时运行项目的服务，用来边写边预览，通常在浏览器里通过 localhost 加端口号访问。

详细解释

开发服务器像彩排舞台：只在你自己的电脑上跑，方便随时看效果，但外人看不到。执行 npm run dev 后，终端会显示类似 localhost:5173 或 localhost:3000 的地址，在浏览器打开就能看到页面。

它为开发提供了很多便利：改代码后自动更新页面（热更新）、报错时显示详细信息，但没有做压缩优化，不能当正式网站用。关掉终端窗口，服务就停了。

常见问题：端口被占用时会换端口或报错；页面打不开时先看终端有没有报错。终端报错和浏览器控制台报错是两回事，发给 AI 时要说清楚是哪里的。

可以直接贴给 Cursor、Claude Code 等工具，把里面的业务内容换成你自己的。

执行 npm run dev 后终端报错，页面打不开，终端完整输出如下：（粘贴输出）。请判断是依赖没装好、端口被占用还是代码错误，给出排查步骤，每一步告诉我要执行什么命令。