Troubleshooting

[中文]

Note

  • Set idf.openOcdDebugLevel to 4 or higher to enable debug logging in the OpenOCD server output.

  • Set logLevel in your <project-directory>/.vscode/launch.json to 3 or higher to display more debug adapter output.

In Visual Studio Code, go to View > Output and select ESP-IDF from the dropdown. This output provides useful information about the extension’s activity.

In Visual Studio Code, go to View > Command Palette... and type ESP-IDF: Doctor Command to generate a report of your environment configuration. This report will be copied to your clipboard for easy pasting.

Check the log file located at:

  • Windows: %USERPROFILE%\.vscode\extensions\espressif.esp-idf-extension-VERSION\esp_idf_vsc_ext.log

  • macOS/Linux: $HOME/.vscode/extensions/espressif.esp-idf-extension-VERSION/esp_idf_vsc_ext.log

In Visual Studio Code, go to Help > Toggle Developer Tools and copy any errors from the Console tab related to this extension.

Visual Studio Code allows you to configure settings at different levels: Global (User Settings), Workspace and Workspace Folder. Ensure your project uses the correct settings. The output from ESP-IDF: Doctor command will show the settings currently in use.

Review OpenOCD Troubleshooting FAQ for information related to OpenOCD output, application tracing, debugging, or any OpenOCD issues.

Note

If you receive errors like “unable to create symlink” while cloning ESP-IDF on Windows, enabling Developer Mode may help resolve the issue.

If you cannot resolve the error, please search the GitHub Repository Issues for existing issues or create a new issue here.