vs
Reference

Legacy Version Files

Compatibility files currently supported by the generic project resolver.

vs-config currently supports a small set of generic legacy version files.

Supported files

  • .tool-versions
  • .nvmrc
  • .node-version
  • .sdkmanrc

Parsing behavior

.tool-versions

nodejs 20.11.1
java 21-tem

.nvmrc

20.11.1

.sdkmanrc

java=21-tem

Precedence with .vs.toml

Project TOML files take precedence over these compatibility files. The resolver checks TOML files first, then falls back to the nearest supported generic legacy file.

Plugin manifests can describe additional legacy filenames

Both plugin backends expose legacy_filenames metadata, but the current generic project resolver only auto-detects the built-in set listed above. Treat plugin-specific legacy parsing as backend capability, not as a replacement for the generic resolver.

Shims and PATH

Understand where runtimes live on disk and how vs builds an execution environment.

Plugins

Compare the two plugin tracks supported by vs and the shared concepts between them.

On this page

Supported filesParsing behaviorPrecedence with .vs.toml