Skip to content

troubleshooting.md

Latest commit

 

History

History
106 lines (72 loc) · 3.3 KB

troubleshooting.md

File metadata and controls

106 lines (72 loc) · 3.3 KB
Raw

Troubleshooting Guide

This guide helps you resolve common issues with the TON VS Code extension and Language Server in general.

Common Issues

Extension Not Working

If the extension is not working as expected:

  1. Make sure you have the latest version of VS Code installed
  2. Try reloading VS Code (Command Palette > Developer: Reload Window)
  3. Check the extension is enabled (Extensions view > search for "TON")
  4. Check if any other Tolk extensions are disabled to avoid conflicts

Standard Library Not Found

If you see the error "Tolk standard library is missing! Try installing dependencies with 'yarn/npm install' or specify ton.tolk.stdlib.path in settings":

  1. First, try installing dependencies in your project:

    yarn install
# or
npm install

  2. If this doesn't help, try set ton.tolk.stdlib.path in settings:

    • Open VS Code Settings
    • Search for "Tolk: General › Stdlib Path"
    • Set the path to your stdlib directory

  3. After making any changes:

    • Reload VS Code window (Command Palette > Developer: Reload Window)
    • Or restart VS Code completely

Installing Previous Version

If you encounter issues with the latest version, you can install a previous version:

  1. Open Command Palette in VS Code (Ctrl+Shift+P / Cmd+Shift+P)
  2. Type and select "Extensions: Install Specific Version of Extension..."
  3. Select "TON" from the list
  4. Choose the version you want to install from the dropdown
  5. VS Code will automatically uninstall current version and install the selected one

To prevent automatic updates:

  • Open VS Code Settings
  • Search for "Extensions: Auto Update"
  • Uncheck the option to disable automatic updates
  • Or add this to your settings.json: 
    "extensions.autoUpdate": false

Finding Logs

The language server generates logs that can help diagnose issues:

For VS Code extension, logs can be found in:

  • Windows: %USERPROFILE%\.vscode\extensions\ton-core.vscode-ton-[version]\dist\ton-language-server.log
  • macOS/Linux: ~/.vscode/extensions/ton-core.vscode-ton-[version]/dist/ton-language-server.log

Also, you can view extension logs directly in VS Code:

  1. Open "View > Output" menu (or press Ctrl+Shift+U / Cmd+Shift+U)
  2. Select "Tolk" from the dropdown menu in the Output panel

These logs are helpful when reporting issues on GitHub.

Acton CLI Not Found

If Acton code lenses, formatting, tests, or diagnostics fail because the executable is missing:

  1. Make sure the acton command is available in your shell.

  2. If Acton is installed in a custom location, set:

    "ton.acton.path": "/absolute/path/to/acton"

  3. Reload VS Code after changing the setting.

Reporting Issues

If you encounter an issue not covered here:

  1. Check the GitHub Issues to see if it's already reported
  2. If not, create a new issue with:
    • VS Code version
    • Extension version
    • Steps to reproduce
    • Error messages (if any)
    • Logs from the language server (see above)
    • Logs from the extension (see above)
    • Your project's configuration files

Getting Help