# Using the Fuchsia extension for VS Code This extension adds support for working with Fuchsia targets and source code. > [!NOTE] > **Note:** To see how to perform the initial installation and configuration of the extension, see [Installing the Fuchsia extension for VS Code](https://fuchsia.dev/docs/reference/tools/editors/vscode/fuchsia-ext-install). ## Compatibility The Fuchsia extension is compatible with ffx `2025-08-12T20:40:15+00:00` and forward. ## Edit code By default, VS code provides syntax highlighting, errors and warnings, jumping to a definition, and lists references for C++. > [!NOTE] > **Note:** The Fuchsia extension does not directly implement support for C++ editor. Instead, it relies on additional VS Code extensions for that functionality. VS Code actively analyzes your code in the background and can show you various warnings or errors. For more information, see [Errors and warnings](https://code.visualstudio.com/Docs/editor/editingevolved#_errors-warnings). The Fuchsia extension also provides syntax highlighting for [FIDL](https://fuchsia.dev/docs/concepts/fidl/overview) and [CML](https://fuchsia.dev/reference/cml). ## Core features All features are accessible via the VS Code command palette `Ctrl+Shift+P` (Linux/Windows) or `Cmd+Shift+P`(Mac). Type "Fuchsia" in the command palette to see a list of available commands. ![This figure shows Fuchsia commands with the command palette.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-command-palette-fx.png) ### Building Fuchsia #### fx set This feature allows you to interactively select product, board, compilation mode, and packages for your Fuchsia build. The current build configuration shows at the top of the list. ![This figure shows the list of products from fx set.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-set-product.png) Packages show a history of selections made within the session. ![This figure shows the history list of packages from fx set.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-set-packages.png) #### fx build Run Fuchsia builds within VS Code. The extension displays current build progress and you can see more details in `Output > Fuchsia Extension`. ![This figure shows fx build in the command palette and build progress.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-build.png) > [!TIP] > **Tip:** Set `fx build` as the default build task to run with `Ctrl+Shift+B` (Linux/Windows) or `Cmd+Shift+B` (Mac). For a custom keyboard shortcut, assign one in Preferences:Keyboard Shortcuts. File paths in the build output errors are clickable, allowing you to jump directly to the error in the source code. ![This figure shows the fx build error in the output and occurrence in the file.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-build-output.png) The extension parses build output to show C++ and Rust errors in the "Problems" panel of VS Code. ![This figure shows the fx build error in the output and occurrence in the file.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-build-problems.png) #### fx serve Start and stop the package server from the command palette. ![This figure shows the commands to start and stop a package server.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-package-server.png) #### fx ota Trigger an over-the-air update for a connected device. ![This figure shows an ota update with details of the build.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-fx-ota.png) ### Target management #### Connect to a Fuchsia device The Fuchsia extension allows you to connect to a Fuchsia target which can be a physical device or an emulator. The extension supports multiple target devices and allows you to easily switch between various Fuchsia devices. You can only connect to a single device at any given time. > [!NOTE] > **Note:** For more information on getting started with Fuchsia and starting an emulator, see [Get started with Fuchsia](https://fuchsia.dev/docs/get-started/README). If your emulator is properly configured and started, you should see a and the name of your Fuchsia device in the status bar of VS Code. If you are using the emulator and not seeing a Fuchsia device, see [Start the Fuchsia emulator](https://fuchsia.dev/docs/get-started/set_up_femu). ![This figure shows the how to connect the Fuchsia VS Code extension to a Fuchsia device.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-connect-target.png) #### Target interaction You can click the and the name of your Fuchsia device in the status bar of VS Code to see the various options that you have for your Fuchsia devices. ![This figure shows the various options to control a connected Fuchsia device through the Fuchsia VS Code extension.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-target-options.png) - **VSCode Target device: ``**: Shows current Fuchsia device configured as the active target for the Fuchsia VSCode extension's features. - **Switching between targets** : If you have additional targets, select `Use target device: ` to switch to that specific target. - **Emulator control** : Start and stop the Fuchsia emulator (`ffx emu`). - **Target controls** : Reboot or power off a connected target. Reboot shows until the target is available. - **Capturing a snapshot**: Capture a snapshot of the active device. ### Viewing Logs The Fuchsia extension allows you to view the symbolized logs (human-readable stack traces) for your connected Fuchsia device. This is equivalent to running `ffx log`. For more information on `ffx log`, see [Monitor device logs](https://fuchsia.dev/docs/development/tools/ffx/workflows/view-device-logs#monitor-device-logs). Select **Fuchsia logs** from the drop-down in the **Output** tab to see the device logs. ![This figure shows logs from the Fuchsia extension in the output tab.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-output-logs.png) > [!NOTE] > **Note:** When you first open the **Fuchsia logs** tab, it may take a few minutes to load all of the available Fuchsia logs. If no logs display, it may be an indication that you do not have connected a Fuchsia device or an emulator. #### Clear Fuchsia logs Once the Fuchsia extension has streamed the Fuchsia logs, you can clear the listed Fuchsia logs to see the incoming logging events for your Fuchsia device. To clear the Fuchsia logs, click the in the top right corner of the **Fuchsia logs** tab. #### Auto-scroll Fuchsia logs To toggle auto-scroll for Fuchsia logs, click the in the top right corner of the **Fuchsia logs** tab. ### Debug code The Fuchsia extension integrates the [zxdb](https://fuchsia.dev/docs/development/debugging/debugging) debugger into the VS Code IDE. #### Component explorer The Fuchsia extension provides a tree view of components on your Fuchsia device. This is the equivalent of running [`ffx component list`](https://fuchsia.dev/reference/tools/sdk/ffx#ffx_component_list). To view the Fuchsia component list, open **Run and Debug** in the Activity Bar and expand the **Fuchsia Components** section. To debug a component, click the to the right of the component name. ![This figure shows the Fuchsia component list in the Fuchsia extension.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-components-debug.png) You can hover over a component to see its lifecycle information or click on it to view more details. This opens a new window with details of the component and is the equivalent of running [`ffx component show `](https://fuchsia.dev/reference/tools/sdk/ffx#ffx_component_show). ![This figure shows the details of a component in the Fuchsia extension either by hovering over the component name or by clicking on the component name.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-components-show.png) You can right click a component to control the component's lifecycle. For more information, see [Component lifecycle](https://fuchsia.dev/docs/concepts/components/v2/lifecycle). ![This figure shows component start on 'hello world' and the log response.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-components-start.png) #### Task explorer The Fuchsia extension provides a tree view of all jobs, processes, and threads running in the Fuchsia system. To view the Fuchsia task explorer, open **Run and Debug** and expand the **Fuchsia Jobs, Processes, and Threads** section. To attach a debugger to a task, click the to the right of the process. ![This figure shows the Fuchsia task explorer in the Fuchsia extension.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-process-explorer.png) ### Testing #### Test explorer Run and debug tests within the VS Code UI. You can find the Test Explorer in the activity bar. ![This figure shows the Fuchsia tests in the extension.](https://fuchsia.dev/static/fuchsia-src/reference/tools/editors/vscode/images/extensions/ext-test.png) [](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/reference/tools/editors/vscode/fuchsia-ext-using.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/reference/tools/editors/vscode/fuchsia-ext-using.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/reference/tools/editors/vscode/fuchsia-ext-using.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/reference/tools/editors/vscode/fuchsia-ext-using.md "Edit the source code of this page")