VLS - V Language Server

Build with: v .

Place the vls binary in your PATH. For example, on Linux you can place it in /usr/local/bin. On Windows, you can place it in a directory that is included in your PATH environment variable.

Otherwise, you can set the path to the vls binary in your editor's settings.

Installing VLS for your editor

• Sublime Text

• VS Code

• Zed

Other editor?

Sublime Text

1. Build VLS with v . and place the resulting vls binary in your PATH.
2. In Sublime Text, open Package Control: Install Package from the Command Palette and install both V (for the source.v syntax) and LSP.
3. Open Preferences > Package Settings > LSP > Server Configurations and add this to Packages/User/LanguageServers.sublime-settings:

{
  "vls": {
    "enabled": true,
    "command": ["vls"],
    "selector": "source.v"
  }
}

If vls is not in Sublime Text's PATH, replace it with the absolute path to the binary. If the V compiler is not in that PATH either, use absolute paths and add VLS_V_COMMAND:

{
  "vls": {
    "enabled": true,
    "command": ["/absolute/path/to/vls"],
    "selector": "source.v",
    "env": {
      "VLS_V_COMMAND": "/absolute/path/to/v"
    }
  }
}

Open a folder containing a V project, then open a .v file. The Sublime status bar should show that VLS has started. Use Tools > Developer > Show Scope Name to confirm that the file's base scope is source.v if the server does not start.

VS Code

Install the V extension from the Visual Studio Marketplace. Its source and build instructions are in vlang/vscode-vlang.

Build VLS with v . and make the vls binary available in VS Code's PATH, or set v.vls.command to its path. Set v.executablePath if the V compiler is not on that PATH.

The extension includes V: Build, V: Run, and V: Test in the Command Palette and in Tasks: Run Task. Runnable CodeLens actions show their output in a task terminal. Test tasks also visualize line coverage; set v.vls.coverage.enabled to false to turn that off.

Features

Instant errors

Go to definition

gddemo.mov

Autocomplete for module functions

Information about function parameters

Autocomplete for struct fields and methods

Zed

NOTE: the Zed editor lacks first-party support for the V programming language.

1. Build VLS with v . and place the resulting vls binary in your PATH.
2. Open Zed > Open Settings File and add this to your settings file:

{
  "languages": {
    "V": {
      "formatter": {
        "external": {
          "command": "vls",
          "arguments": ["-"]
        }
      }
    }
  }
}

or alternatively if the vls binary is NOT in your PATH:

{
  "languages": {
    "V": {
      "formatter": {
        "external": {
          "command": "/absolute/path/to/vls",
          "arguments": ["-"]
        }
      }
    }
  }
}