在 vite 项目中,预览服务器通过执行 npx vite preview 命令启动,它会基于构建产物(默认位于 dist 目录)提供静态文件服务。该功能主要用于在生产环境部署前验证打包结果,确保资源路径正确且无运行时错误。

如何自定义预览服务器的端口和主机地址
可以通过命令行参数直接指定 --port 和 --host 来覆盖默认配置。例如,使用 npx vite preview --port 3000 --host 0.0.0.0 即可将服务绑定到本地所有网络接口的 3000 端口,方便局域网内其他设备访问测试。

npx vite preview --port 3000 --host 0.0.0.0
如何指定非默认的构建输出目录
如果构建产物不在默认的 dist 目录,可以使用 --dir 参数指向实际目录。例如,若构建输出在 build-output 文件夹,运行 npx vite preview --dir build-output 即可对该目录下的内容进行预览。
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。

npx vite preview --dir build-output
预览服务器如何处理 HTML5 History 模式的 404 问题
Vite 的预览服务器默认不支持 HTML5 History 模式的路由回退。当用户刷新深度链接页面时,服务器会返回 404 错误。这是因为预览服务器仅作为简单的静态文件服务器,不具备像 Nginx 或 Apache 那样的重写规则能力。要解决此问题,需手动配置一个中间件或使用支持 SPA 路由的静态服务器工具(如 serve 或 http-server)来替代内置预览服务。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










