# 设备树文件

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

[设备树](https://elinux.org/Device_Tree_Usage)是一种主要用于描述硬件的分层数据结构。

CLion 识别  `.dts`  /  `.dtsi`  文件，并为其提供代码辅助和代码分析功能。

Procedure: 配置板卡（Zephyr）

如果您正在使用 [Zephyr](https://www.zephyrproject.org)，请确保在设置中选择您正在使用的板卡：

1. 转到  `设置 | 语言与框架 | Devicetree` 。

2. 使用以下选项之一：

* 从 CMake 派生 Zephyr 设置 与 CMake 同步 选项默认启用。 请注意，需要使用 `find_package(Zephyr)` 命令来获取板卡名称。

* 指定 Zephyr 安装路径并选择板卡 清除 与 CMake 同步 复选框。 如果未自动检测到 Zephyr 的安装路径，请提供路径并从列表中选择板卡： ![选择板卡](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_board_settings.png)

> **Tip:**
> 了解更多关于 [Zephyr 中的设备树](https://docs.zephyrproject.org/latest/build/dts/index.html)的信息。

Procedure: 辅助编码

以下是设备树文件可用的一些编码辅助功能示例。

* 语法高亮和代码格式化：

![设备树的语法高亮和代码格式化](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_syntaxhighlight.png)

> **Tip:**
> 您可以在  `设置 | 编辑器 | 配色方案 | Devicetree`  中配置配色方案，并在  `设置 | 编辑器 | 代码样式 | Devicetree`  中配置代码样式。

* 节点的代码折叠：

![代码折叠边栏图标](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_folding_unfold.png)

![折叠的代码块](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_folding_fold.png)

> **Tip:**
> 按 `Ctrl+Shift+NumPad -` (Windows), `⌘ ⇧ NumPad -` (macOS), `⌘ ⇧ NumPad -` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ Minus` (macOS System Shortcuts), `Ctrl+Shift+NumPad -` (XWin), `Ctrl+Shift+NumPad -` (GNOME), `Ctrl+Shift+NumPad -` (KDE), `Ctrl+Shift+NumPad -` (Emacs), `Ctrl+K, Ctrl+1` (Sublime Text), `⌘ K, ⌘ 1` (Sublime Text (macOS)), `⌘ ⇧ NumPad -` (Xcode), `Ctrl+M, A` (Visual Studio), `⌃ M, A` (Visual Studio (macOS)), `Ctrl+M, A` (ReSharper), `⌃ M, A` (ReSharper (macOS)), `Ctrl+Shift+NumPad -` (QtCreator), `⌘ ⇧ NumPad -` (QtCreator (macOS)), `Ctrl+Shift+NumPad -` (NetBeans), `Ctrl+Shift+NumPad /` (Eclipse), `⌘ ⇧ NumPad /` (Eclipse (macOS)) 折叠所有代码片段，按 `Ctrl+Shift+NumPad +` (Windows), `⌘ ⇧ NumPad +` (macOS), `⌘ ⇧ NumPad +` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ Plus` (macOS System Shortcuts), `Ctrl+Shift+NumPad +` (XWin), `Ctrl+Shift+NumPad +` (GNOME), `Ctrl+Shift+NumPad +` (KDE), `Ctrl+Shift+NumPad +` (Emacs), `Ctrl+K, Ctrl+J` (Sublime Text), `⌘ K, ⌘ J` (Sublime Text (macOS)), `⌘ ⇧ NumPad +` (Xcode), `Ctrl+M, X` (Visual Studio), `⌃ M, X` (Visual Studio (macOS)), `Ctrl+M, X` (ReSharper), `⌃ M, X` (ReSharper (macOS)), `Ctrl+Shift+NumPad +` (QtCreator), `⌘ ⇧ NumPad +` (QtCreator (macOS)), `Ctrl+Shift+NumPad +` (NetBeans), `Ctrl+NumPad *` (Eclipse), `⌘ NumPad *` (Eclipse (macOS)) 展开所有代码片段。
>
>
>
> 有关更多信息，请参阅 [代码折叠](working-with-source-code.html#code_folding)。

* 设备树元素的快速文档：

![设备树元素的快速文档](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_quickdoc.png)

> **Tip:**
> 显示文档时，CLion 会从 [Zephyr 绑定](https://docs.zephyrproject.org/latest/build/dts/bindings-syntax.html#property-entry-syntax)加载附加信息。

默认情况下，快速文档会在鼠标悬停时显示。 有关如何更改此设置以及此功能的一般信息，请参阅 [快速文档](viewing-inline-documentation.html)。

* 设备树文件的结构视图：

![设备树的结构视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_structureview.png)

要打开结构视图，请转到主菜单中的  `视图 | 工具窗口 | 结构`  或按 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS))。

* 标准属性、  `/commands/` 、标签和代码元素的代码补全：

![dts 命令的代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_completion.png)

![dts 元素的代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_completion_watchdog.png)

* 用于指示被覆盖属性的行标记。 您还可以使用它导航到原始属性：

![高亮显示被覆盖的属性](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_overriddenprop.png)

![导航到被覆盖的属性](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_overriddenprop_hover.png)

* 在您输入时自动插入缺失的分号、匹配的大括号和引号。

Procedure: 设备树代码的快速修复和意图

* CLion 为您的设备树代码提供了一组检查。

您可以在  `设置 | 编辑器 | 检查`  中浏览和调整检查列表：

![设备树检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_inspections.png)

例如，CLion 会验证代码中的名称：

![名称验证](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dts_badcharacter.png)

## See also

### 流程

[多线程 RTOS 调试](rtos-debug.html)

