You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: update Node version requirement to address package manager issues (#5811) [ci skip]
It's recommended to use NPM v6 with Node.js v8, because:
1. Some of the upstream packages may accidentally introduce dependencies
that require Node.js 10+ in the `engines` field. This only leads to a
warning in NPM but will break Yarn.
2. NPM v5 does not support dependency versions starting with `npm:`,
so it can't support Vue 3 related features in Vue CLI.
Copy file name to clipboardExpand all lines: docs/guide/installation.md
+6-3Lines changed: 6 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,10 @@ If you have the previous `vue-cli` (1.x or 2.x) package installed globally, you
6
6
:::
7
7
8
8
::: tip Node Version Requirement
9
-
Vue CLI requires [Node.js](https://nodejs.org/) version 8.9 or above (8.11.0+ recommended). You can manage multiple versions of Node on the same machine with [nvm](https://github.com/creationix/nvm) or [nvm-windows](https://github.com/coreybutler/nvm-windows).
9
+
Vue CLI 4.x requires [Node.js](https://nodejs.org/) version 8.9 or above (v10+ recommended). You can manage multiple versions of Node on the same machine with [n](https://github.com/tj/n), [nvm](https://github.com/creationix/nvm) or [nvm-windows](https://github.com/coreybutler/nvm-windows).
10
+
11
+
As Node.js v8 has reached end-of-life, it's now recommended to use Node.js v10+ for best compatibility.
12
+
If you have to stay with Node.js v8, please make sure npm v6 is used as the default package manager. (`npm -v` to check the version, and `vue config --set packageManager npm` to set the default package manager.)
10
13
:::
11
14
12
15
To install the new package, use one of the following commands. You need administrator privileges to execute these unless npm was installed on your system through a Node.js version manager (e.g. n or nvm).
@@ -38,15 +41,15 @@ yarn global upgrade --latest @vue/cli
38
41
39
42
#### Project Dependencies
40
43
41
-
Upgrade commands shown above apply to the global Vue CLI installation. To upgrade one or more `@vue/cli` related packages (including packages starting with `@vue/cli-plugin-`) inside your project, run `vue upgrade` inside the project directory:
44
+
Upgrade commands shown above apply to the global Vue CLI installation. To upgrade one or more `@vue/cli` related packages (including packages starting with `@vue/cli-plugin-` or `vue-cli-plugin-`) inside your project, run `vue upgrade` inside the project directory:
42
45
43
46
```
44
47
Usage: upgrade [options] [plugin-name]
45
48
46
49
(experimental) upgrade vue cli service / plugins
47
50
48
51
Options:
49
-
-t, --to <version> Upgrade <package-name> to a version that is not latest
52
+
-t, --to <version> Upgrade <plugin-name> to a version that is not latest
50
53
-f, --from <version> Skip probing installed plugin, assuming it is upgraded from the designated version
51
54
-r, --registry <url> Use specified npm registry when installing dependencies
0 commit comments