本文总结了在使用 UniApp 开发的 H5 项目中，刷新页面出现 404 错误的问题及解决方案。 **问题现象：** UniApp H5 项目部署后，首次访问页面正常，但刷新页面出现 404 错误。 **问题原因：** 由于 UniApp 使用 History 模式路由，刷新时服务器尝试访问不存在的物理文件。 **解决方案：** 修改 Nginx/OpenResty 配置，添加以下代码： ```nginx location / { try_files $uri $uri/ /index.html; } ``` **原理：** `try_files` 指令依次尝试访问请求的 URI、作为目录的 URI，如果都不存在则返回 `/index.html`，由前端路由接管 URL 解析。 **注意事项：** 修改配置后需重启 Nginx/OpenResty 使配置生效。

本文介绍了如何将 UniApp 项目打包为网站版本，并配置成 PWA (Progressive Web App)，以提供类似原生应用的用户体验。主要涉及三个核心文件：`manifest.json`、`service-worker.js` 和 `index.html`。`manifest.json` 定义了 PWA 的名称、图标、启动 URL 等信息；`service-worker.js` 负责缓存资源，实现离线访问；`index.html` 引入 `manifest.json` 并注册 `service-worker.js`。 文章提供了这些文件的配置示例，并说明了配置完成后在浏览器中会出现的提示。

Node-sass 已经被废弃，需要替换为 sass。 卸载 node-sass 的方法是使用 npm，然后安装 sass。

本文档总结了使用 `vue-cli` 构建和运行 uni-app 项目的步骤，包括： 1. **全局安装 `vue-cli`：** `npm install -g @vue/cli` 2. **创建 uni-app 项目：** `vue create -p dcloudio/uni-preset-vue my-project` 3. **运行和发布 uni-app：** 使用 `npm run dev:%PLATFORM%` 和 `npm run build:%PLATFORM%` 命令，其中 `%PLATFORM%` 代表不同的平台，如 `app-plus`, `h5`, `mp-weixin` 等。 4. **npm 更换源：** 提供更换 npm 源的命令，包括清除缓存、安装 cnpm 和设置 cnpm 源。