页面没有正常加载

你可能是直接双击了 index.html

浏览器不允许 file:// 页面加载 ES Module 脚本，所以双击打开一定是白屏。 本项目是单页应用（SPA），必须通过 HTTP 访问。

在解压目录执行任意一条命令，然后访问 http://127.0.0.1:8080：

python -m http.server 8080
npx serve .
npx vite preview --port 8080

Windows 用户可直接双击包内 _preview/preview.bat 一键启动。

资源 404 / 路径不对

常见原因与处理：

• 部署在子目录（如 /softtool/）：需要用子路径重新构建 npx vite build --base=/softtool/，否则 /assets/* 会请求到站点根。
• 压缩包多套了一层目录：站点根目录下应直接是 index.html， 而不是 dist/index.html。
• Nginx 未配置回退：location / { try_files $uri $uri/ /index.html; }。

按 F12 打开控制台，看 Network 里哪些请求是 404，即可定位具体路径。