# FAQ

# Install an old version of Vetur

Sometimes new releases have bugs that you want to avoid. Here's an easy way to downgrade Vetur to a working version:

Set "extensions.autoUpdate": false.
Find the version you want and download VSIX https://github.com/vuejs/vetur/blob/master/CHANGELOG.md (opens new window).
Install VSIX following this guide: https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix (opens new window).

# No Syntax Highlighting & No Language Features working

The two possible causes are:

Other extensions also contribute a Vue language, and that conflicts with Vetur.
VS Code didn't install Vetur properly.

For 1, try disabling all other Vue related extensions.

For 2, try these methods:

Run command: Developer: Reinstall Extension for Vetur.
Remove Vetur in your extensions folder (opens new window) and do a clean reinstall.
(Windows): Try removing & reinstall Vetur with admin privilege.
If nothing above works, download the latest pre-packaged vsix file (opens new window) and install through vsix (opens new window).

# Vetur Crash

If it says cannot find module <some-module>, go to Vetur's client code installation directory and run yarn or npm install. This is usually caused by VS Code not correctly updating Vetur's dependencies from version to version. Paths:
- Win: %USERPROFILE%\.vscode\extensions\octref.vetur-<version>\client
- Mac: ~/.vscode/extensions/octref.vetur-<version>/client
- Linux: ~/.vscode/extensions/octref.vetur-<version>/client
You can also try uninstall/reinstall Vetur.
More details at: https://github.com/vuejs/vetur/issues/352#issuecomment-318168811 (opens new window)
If it says problem related to memory and cpu, try to add a jsconfig.json or tsconfig.json and only include Vue-related code: https://vuejs.github.io/vetur/setup.html (opens new window)

# Vetur can't recognize components imported using webpack's alias

You need to setup path mapping in jsconfig.json or tsconfig.json: https://www.typescriptlang.org/docs/handbook/module-resolution.html (opens new window). For example:

// Webpack
module.exports = {
  resolve: {
    alias: {
      '@': 'src'
    }
  }
}

// tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": [
        "src/*"
      ]
    }
  }
}

# `Property 'xxx' does not exist on type 'CombinedVueInstance'`

If you are getting a lot of Property 'xxx' does not exist on type 'CombinedVueInstance' errors, it's an issue with Vue's typing and TypeScript.

You can work around it by:

Annotating return type for each computed property, by either adding JSDoc (opens new window) or TS types (opens new window).
Setting vetur.validation.interpolation: false. You'll not get any template error checking.
Downgrading TS to a version before 3.4 and enabling vetur.useWorkspaceDependencies. You'll not get support for new TS syntaxes, such as optional chaining.
Use Composition API (opens new window).

# Template Interpolation auto completion does not work

You are running into the same issue as above — not typing return type of computed. Please add JSDoc (opens new window) or TS types (opens new window) for computed properties.

# Vetur cannot recognize my Vue component import, such as `import Comp from './comp'`

You need to add .vue extension when importing SFC.

More details at: https://github.com/vuejs/vetur/issues/423#issuecomment-340235722 (opens new window)

# .vue file cannot be imported in TS file

You need to add declare module '*.vue' in your dts files: https://github.com/Microsoft/TypeScript-Vue-Starter#single-file-components (opens new window).

# How to build and install from source

To build and install the extension from source, you need to install vsce (opens new window).

Then, clone the repository and compile it.

git clone https://github.com/vuejs/vetur
cd vetur
yarn
yarn compile
vsce package

Now you'll find vetur-{version}.vsix, you can install it by editor command "Install from VSIX".

# Vetur uses different version of TypeScript in .vue files to what I installed in `node_modules`.

You can enable the Vetur: Use Workspace Dependencies setting so that Vetur uses the same version of TypeScript in your workspace. NB: It will use typescript.tsdk setting as the path to look for if defined, defaulting to node_modules/typescript. This enables tools like Yarn PnP to set their own custom resolver.

# Vetur is slow

You can run the command Vetur: Restart VLS (Vue Language Server) to restart VLS.

However, we'd appreciate it if you can file a performance issue report with a profile (opens new window) to help us find the cause of the issue.

# Vetur can't find `tsconfig.json`, `jsconfig.json` in /xxxx/xxxxxx.

If you don't have any tsconfig.json, jsconfig.json in your project, Vetur will use fallback settings. Some features such as including path alias, decorator, and import json won't work.

You can add this config in correct position in your project or use vetur.config.js to set the file path.

If you want debug info, you can use Vetur: show doctor info command.
You can use vetur.ignoreProjectWarning: true in vscode setting to close this warning.

⚠️ Notice ⚠️ : If you don't need (path alias/decorator/import json) feature, you can just close it.

# Vetur can't find `package.json` in /xxxx/xxxxxx.

If you don't have any package.json in your project, Vetur can't know the Vue version and component data from other libs. Vetur assumes that the version of Vue is less than 2.5. If the version is wrong, you will get wrong diagnostics from typescript and eslint template validation.

You can add this config at the correct position in your project or use vetur.config.js to set file path.

Read more vetur.config.js

If you want debug info, you can use Vetur: show doctor info command.
You can use vetur.ignoreProjectWarning: true in vscode setting to close this warning.

# Vetur found xxx, but they aren't in the project root.

Vetur found the file, but it may not actually be what you want. If it is wrong, it will cause same result as the previous two. ref1, ref2

You can add this config at the correct position in your project or use vetur.config.js to set file path.

Read more vetur.config.js

If you want debugging info, you can use the Vetur: show doctor info command.
You can use vetur.ignoreProjectWarning: true in vscode settings to close this warning.

← Global components