Troubleshooting

TypeScript assistance is missing#

Confirm LSP4IJ is installed and enabled, with version 0.21.0 or newer on the 2026.2 platform. Check the language-server output and installed project dependencies.

A component import does not resolve#

Inspect the relative path, package export, or tsconfig.json alias. For .astro?container imports, confirm the project version supports the syntax. Wait for indexing after changing dependencies.

A preview configuration rejects flags#

Check the installed Astro version and the selected run task. Version-specific flags such as Astro 7.3 preview --ignore-lock cannot be used with arbitrary older versions or conflicting background options.

Report an issue#

Use email support and include:

• Your IDE edition and full build number from Help → About.
• The installed plugin version; this manual covers 2026.1.5.
• Relevant external-tool versions, the failing action, and a small reproducible example.
• The error message and relevant log excerpt, with credentials and private project data removed.

Use Help → Show Log in Finder/Explorer to locate IDE logs when requested. Describe what you expected to happen and whether the same operation works from a terminal.