117 lines
4.0 KiB
Markdown
117 lines
4.0 KiB
Markdown
|
# 常见问题
|
|||
|
|
|
|||
|
|
本篇介绍一些常见的问题，会持续更新。
|
|||
|
|
|
|||
|
|
## 1. 如何设置/修改首页？
|
|||
|
|
|
|||
|
|
`vue` 文件的 `route-block` 块里面设置 `type="home"` 即可，请确保项目里面 `只有一个页面` 是这个配置。
|
|||
|
|
|
|||
|
|
> 注意：如果有多个，会按照字母顺序排列，第一个是首页。（可能不是您的想要的效果。）
|
|||
|
|
|
|||
|
|
## 2. 修改 `pages.json`、`manifest.json` 被覆盖问题
|
|||
|
|
|
|||
|
|
- `pages.json`
|
|||
|
|
|
|||
|
|
本项目引入了 `@uni-helper/vite-plugin-uni-pages`，`pages.json` 文件将会自动生成，手动修改 `pages.json` 将会被覆盖。
|
|||
|
|
|
|||
|
|
全局的东西请在 `pages.config.ts` 里面配置，页面的东西请在 `vue` 文件的 `route-block` 配置。
|
|||
|
|
|
|||
|
|
- `manifest.json`
|
|||
|
|
|
|||
|
|
与上面类似。本项目引入了 `@uni-helper/vite-plugin-uni-manifest`，`manifest.json` 文件将会自动生成，手动修改 `manifest.json` 将会被覆盖。
|
|||
|
|
|
|||
|
|
如需修改，请在 `manifest.config.ts` 里面修改。
|
|||
|
|
|
|||
|
|
## 3. 怎么分包？
|
|||
|
|
|
|||
|
|
`vite.config.ts` 里面有一个配置，如下：(其中 `subPackages` 就是用来分包的)
|
|||
|
|
|
|||
|
|
```ts [vite.config.ts]{3}
|
|||
|
|
UniPages({
|
|||
|
|
exclude: ['**/components/**/**.*'],
|
|||
|
|
subPackages: ['src/pages-sub'], // 是个数组，可以配置多个
|
|||
|
|
}),
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 首次运行 `pnpm:mp` 时报错。
|
|||
|
|
|
|||
|
|
首次运行 `pnpm:mp` 时报错，报错如下：
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
Error: ENOENT: no such file or directory, open '/Users/burtlai/unibest-projects/unibest/src/manifest.json'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
首次运行 `非h5端` 时都可能出现上面的问题，需要先执行一下 `pnpm i` 以生成 `src/manifest.json` 文件，后面就不会报错了。
|
|||
|
|
|
|||
|
|
## 5. `git commit` 报错。
|
|||
|
|
|
|||
|
|
请看 `commitlint.config.ts` 里面的配置，需要满足对应的设定。根据自己的需要，可以修改 `commitlint.config.ts` 里面的配置。
|
|||
|
|
|
|||
|
|
如果是一次的（比如引入了某个第三方库），可以通过 `--no-verify` 参数跳过校验：
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
git commit -m "feat: xxx" --no-verify
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
第三方库还有另外一种处理方式，放到特定的文件夹，然后在 `.eslintignore` 和 `.styleintignore` 里面加上该文件夹。
|
|||
|
|
|
|||
|
|
## 6. `uni-app` 无法使用 `process.env` 变量，怎么办？
|
|||
|
|
|
|||
|
|
使用 `import.meta.env` 替代！
|
|||
|
|
|
|||
|
|
## 7. 如何跟随 `uni-app` 官方升级？
|
|||
|
|
|
|||
|
|
项目下，执行 `npx @dcloudio/uvm@latest` 即可更新。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
> 注意，上面的命令会自动安装 `vue-i18n`，可以手动删除（`pnpm un vue-i18n`)，也可以不理它（没多大影响）。
|
|||
|
|
|
|||
|
|
## 8. 如何把已经加入 `git` 管理的文件移出 `git` 管理?
|
|||
|
|
|
|||
|
|
- 第一步，先把文件移出`git` 管理，操作如下：
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
# git rm -r --cached file1 file2 ## 针对某些文件
|
|||
|
|
# git rm -r --cached dir1 dir2 ## 针对某些文件夹
|
|||
|
|
# git rm -r --cached . ## 针对所有文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- 第二步，提交 `commit` 以正式删除的文件
|
|||
|
|
|
|||
|
|
> 总结：`git rm -r --cached .` + `git commit` 即可。
|
|||
|
|
|
|||
|
|
## 9. 支付宝小程序运行报错。
|
|||
|
|
|
|||
|
|
- 默认运行是会报错的，如下图
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 只需要勾上 `本地开发跳过 ES5 转译` 即可正常运行，如下图
|
|||
|
|
|
|||
|
|
|
|||
|
|
> 总结：勾上 `本地开发跳过 ES5 转译` 即可。
|
|||
|
|
|
|||
|
|
## 10. 支持 `uni-app x` 吗？
|
|||
|
|
|
|||
|
|
不支持。但我们一直保持关注。[uni-app x 传送门](https://doc.dcloud.net.cn/uni-app-x/)
|
|||
|
|
|
|||
|
|
目前 `unibest` 已经有 `hbx` 模板，后续接入 `uni-app x` 会很容易，坐等官方发布。
|
|||
|
|
|
|||
|
|
## 11. 为啥 `vue` 已经 `3.4+` 了，还不支持 `defineModel` ?
|
|||
|
|
|
|||
|
|
`uni-app` 官方虽然已经把 `vue` 升级到 `3.4+` 了，但是目前只有 `H5端` 支持 `defineModel`，其他端目前运行报错，详情请看 `uni-app` 官网的发布日志：
|
|||
|
|
|
|||
|
|
[HBuilder X - Release Notes](https://3085868976.hiecheimaetu.com:22443/qn-GO8xCsKgpKDZWIBAkVCUkI1EnGmQUMT4.update.dcloud.net.cn/hbuilderx/changelog/4.14.2024043013.html)
|
|||
|
|
|
|||
|
|
关键截图如下：
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
真实运行报错截图如下：（分别是 `小程序` 和 `APP` ）
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
全文完~
|