Ensure running under correct environment
vuepress-theme-hope only supports node version of
If the output of
node -v does not satisfy the requirement, you should download and install the LTS version of Node.js.
Also, you should use a package manager satisfying the following requirements (
pnpm: >= 7
npm i -g pnpm
npm: >= 8
npm i -g npm
yarn: >= 2
npm i -g yarn@2
Ensure using the latest version and having correct deps tree
Please make sure you are using the latest
vuepress-theme-hope V2 version, because some bugs you encountered may have been fixed in new versions.
Also in some cases, you may generate incorrect dependency tree after upgrading some dependencies, this is because both
vue have many packages named
To let VuePress work correctly, there should only be one version of
vue-router in the whole project. Multiple versions of a package can cause different parts of the application to use different instances of Vue and the corresponding package, resulting in errors like
useXXX() is called without provider.
Any official packages starting with
@vuepress/ should be upgrade to the same version as VuePress.
I.E.: if you are using
@vuepress/utils, you should ensure they have the same version number as
Besides, any plugin inside
vuepress-theme-hope should be the same version as vuepress-theme-hope.
Furthermore, if you're using another third-party plugin, make sure it's compatible with the version of VuePress you're upgrading to.
You can execute the following command to make sure you are using the latest version and having correct deps tree.
pnpm dlx vp-update
yarn dlx vp-update
Ensure having correct config
Please confirm that there are no errors in your config file (such as red wavy lines), if so, please modify the config file according to the prompts until you correctly configured VuePress and themes.