ty extension for Visual Studio Code
A Visual Studio Code extension for ty, an extremely fast Python type checker and language server, written in Rust.
The extension ships with ty==0.0.94.
Installation
Install this extension from the Visual Studio Marketplace.
Features
Currently, the extension supports the following features:
- File and workspace level diagnostics
- Hover type information for symbols
- Go to definition
- Go to declaration
- Go to type definition
- Go to symbol
- Open symbol by name
- Find references
- Inlay hints
- Completions
- Signature help
- Highlight references of symbols
- Semantic highlighting
- Symbol renaming
Usage
Once installed in Visual Studio Code, ty will automatically execute when you open or edit a Python or Jupyter Notebook file.
The extension automatically disables the language server from the Python
extension
to avoid running two Python language servers. This is done by setting
python.languageServer to "None" as a default configuration.
If you prefer to use ty only for type checking and want to use another language
server for capabilities like hover, auto-completions, etc., you can override
this by explicitly setting python.languageServer and
ty.disableLanguageServices
in your settings.json:
{
"python.languageServer": "Pylance",
"ty.disableLanguageServices": true,
}If you don't want to use ty for a specific workspace, disable this extension in VS code.
Untrusted Workspace
The extension supports untrusted workspace. For untrusted workspaces, the extension always uses the bundled ty executable and disables uv integration, ignoring the following settings:
ty.experimental.useUvty.importStrategyty.interpreterty.path
Settings
See the ty editor settings reference for an enumeration of all supported settings.
Commands
| Command | Description |
|---|---|
| ty: Restart server | Restart the ty language server |
| ty: Show client logs | Open the "ty" output channel |
| ty: Show server logs | Open the "ty Language Server" output channel |
| ty: Open debug information | Opens a window with debug information |
Requirements
The ty extension works without additional extensions. For Python environment detection, we recommend one of the following:
When either extension is available, ty can find an executable installed in the active Python
environment. You can also set ty.interpreter to a Python executable or environment directory
without either extension. When no interpreter is configured or selected, ty looks for an executable
in the Python environment configured by
environment.python or a local .venv. If no executable is found,
the extension checks PATH before using its bundled ty executable.
Reload VS Code after installing or enabling either extension.
Finding a ty executable through a Python interpreter requires Python 3.8 or later. ty itself can analyze Python 3.8 to 3.14.
Getting help
See the troubleshooting guide to get more information on how to debug issues with the extension or the language server.
Publisher
This extension is published under the astral-sh account, which differs from
our Ruff extension that uses
the "charliermarsh" publisher. Both extensions are official products from Astral.
License
The ty extension is licensed under the MIT license (LICENSE).
