Исправление проблем

Около 1 мин

Убедитесь, что работаете в правильной среде

vuepress-theme-hope поддерживает только версию node ^14.18.0 || >=16.0.0.

Если вывод node -v не удовлетворяет требованию, вам следует загрузить и установить LTS-версию Node.js.

Кроме того, вы должны использовать менеджер пакетов, удовлетворяющий следующим требованиям:

npm: >= 8
Проверить: npm -v
Установить: npm i -g npm
yarn: >= 1.22.15
Проверить: yarn -v
Установить: npm i -g yarn
pnpm: >= 7
Проверить: pnpm -v
Установить: npm i -g pnpm

Убедитесь, что вы используете последнюю версию и имеете правильное дерево зависимостей

Пожалуйста, убедитесь, что вы используете последнюю версию vuepress и vuepress-theme-hope V2, потому что некоторые ошибки, с которыми вы столкнулись, могли быть исправлены в новых версиях.

Кроме того, в некоторых случаях вы можете создать неправильное дерево зависимостей после обновления некоторых зависимостей, потому что и vuepress, и vue имеют много пакетов с именами @vuepress/xxx и @vue/xxx.

Чтобы VuePress работал правильно, во всем проекте должна быть только одна версия @vuepress/xxx @vue/xxx vue и vue-router. Наличие нескольких версий пакета может привести к тому, что разные части приложения будут использовать разные экземпляры Vue и соответствующий пакет, что приведет к таким ошибкам, как useXXX() is called without provider.

Примечание

Любые официальные пакеты, начинающиеся с @vuepress/, должны быть обновлены до той же версии, что и VuePress.

То есть: если вы используете @vuepress/plugin-search и vuepress/utils, вы должны убедиться, что они имеют тот же номер версии, что и vuepress.

Кроме того, любой плагин внутри vuepress-theme-hope должен быть той же версии, что и vuepress-theme-hope.

Более того, если вы используете другой сторонний плагин, убедитесь, что он совместим с той версией VuePress, на которую вы переходите.

Вы можете выполнить следующую команду, чтобы убедиться, что вы используете последнюю версию и имеете правильное дерево зависимостей.

pnpm

pnpm dlx vp-update

yarn

yarn dlx vp-update

npm

npx vp-update

Убедитесь, что у вас правильная конфигурация

Убедитесь, что в вашем файле конфигурации нет ошибок (например, красных волнистых линий), если это так, измените файл конфигурации в соответствии с подсказками, пока вы не настроите VuePress и темы правильно.