常见问题

Mr.Hope ... 2020年10月13日 13:36 FAQ 大约 2 分钟

# 官方 QQ 群

# 构建失败

请确保你使用的是最新版本主题,之后在禁用缓存的情况下重新运行开发服务器: vuepress dev <你的文档地址> --no-cache

如果问题依然存在,请在 GitHub 上 提一个 Issue (opens new window),并完整粘贴运行 vuepress dev <你的文档地址> --debug 时终端输出的内容,如果你的内容与页面显示相关,请一并附上相应的截图。

# 部分页面设置失效

你可以先重新查阅文档,看看该设置是否 不支持页面配置

支持页面配置 意味着主题允许页面的配置能够覆盖全局的同名(同功能)配置,但并不是所有功能都满足此设置。为了项目的编译速度,有些项目在全局配置禁用后不会在编译阶段加载,它们就无法局部启用。

# 代码块在浅色模式 (日间模式) 下不正常

我猜这是你的问题,请你删除 .vuepress/styles/palette.styl 内的 $codeBgColor,主题的默认值是浅蓝色,而默认主题为墨蓝色。

# 访问部分链接 404

如果你使用了中文的分类或者标签,如:

---
category: 软件
tags:
  - 谷歌浏览器
---
1
2
3
4
5

那么你直接访问 /category/软件/tag/谷歌浏览器/ 会被导航到 404 页面

这是 vue-router3.4.6 引入的潜在破坏性更改。自 3.4.6 起,vue-router 要求所有非标准 URL 路径都必须先 encodeURI 再作为路径添加到 router 中。

主题使用 @vuepress/plugin-blog 进行博客支持,该问题应该在此插件中得到修正。Mr.Hope 已经提出了 相关 Issue (opens new window),并提交了 临时解决该问题的 PR (opens new window),但该 PR 并未被接受。

临时解决方案

如果你在使用 yarn,你可以添加 resolutions 字段:

{
  ...
  "resolutions": {
    "vue-router": "3.4.5"
  },
  ...
}
1
2
3
4
5
6
7

到你的 package.json 来临时解决这个问题。

# TypeScript 错误

详见 Typescript 错误排查