# QML 语法支持

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

CLion 提供对  `.qml`  文件的语法支持，适用于 Qt5 和 Qt6。 以下是一些 QML 代码洞察功能的示例。

* QML 类型和属性的高亮显示和代码补全： ![QML 补全](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_completion.png)

* [查找用法](find-highlight-usages.html) 用于 QML 符号，可通过按 `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `⌥ F7` (Xcode), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (ReSharper), `⌥ F7` (ReSharper (macOS)), `Ctrl+Shift+U` (QtCreator), `⌘ ⇧ U` (QtCreator (macOS)), `Alt+F7` (NetBeans), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS)) 或点击编辑器中的提示来调用： ![QML 符号使用提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_usage_editor.png) 在用法弹出窗口中，可以在它们之间导航并调整搜索（ ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)）： ![QML 符号使用弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_usage_popup.png)

* 另一个导航选项是文件内容的 [结构视图](file-structure.html)。 要打开它，请按 `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)) 或从主菜单中选择 `视图 | 工具窗口 | 结构` ： ![QML 文件结构](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_structure_view.png)

* [快速文档](viewing-inline-documentation.html) 弹出窗口也适用于 QML 符号。 通过将鼠标悬停在符号上或按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS)) 来调用： ![QML 符号的快速文档](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_quickdoc.png)

Procedure: 启用 QML 语言服务器

1. 转到  `设置 | 语言与框架 | QML`  并勾选   启用 QML 语言服务器   复选框。

![启用 QML 语言服务器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_settings_server.png)

如果安装了  `qmlls`  组件，此选项将启用 QML 特定的代码检查。

2. 启用   使用 QML 语言服务器的补全功能   以获取基于语言服务器的 QML 符号补全建议，而不是由 CLion 提供的建议。

Procedure: 添加额外的 QML 导入路径

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

2. 在   额外的 QML 导入   字段中，提供包含额外 QML 模块的目录路径。

> **Note:**
> 请确保设置的是相对路径，而不是模块本身的路径。
>
>
>
> 例如，如果在此处指定  `./bin/` ，那么像  `import MYLIB`  这样的导入语句将搜索  `./bin/MYLIB`  目录。

Procedure: QML 代码样式

您可以使用 IDE 设置或 [qmlformat](https://doc-snapshots.qt.io/qt6-dev/qtquick-tools-and-utilities.html#qmlformat) 来配置 QML 的代码样式。

* 默认情况下，qmlformat 是禁用的，CLion 使用内置的代码样式设置。 要访问它们，请转到  `设置 | 编辑器 | 代码样式 | QML` ：

![QML 的代码样式设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_codestyle.png)

要快速访问设置，请在底部状态栏切换器中选择   配置 qml QML 的缩进  ：

![配置 QML 代码样式选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_codestyle_quickopen.png)

* 要启用 qmlformat，请使用状态栏切换器（见上文）或转到  `设置 | 语言与框架 | QML`  并勾选   启用 'qmlformat' 作为格式化工具   复选框。

> **Note:**
> Qmlformat 会覆盖 IDE 的代码样式设置。

![启用 qmlformat](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_enable_qmlformat.png)

启用 qmlformat 后，其指示器会显示在底部状态栏中。 您也可以从那里禁用 qmlformat：

![状态栏中的 qmlformat 指示器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_formatter_bottombar.png)

Procedure: 故障排除：手动启用 QML 语法支持

如果收到编辑器通知，提示 CLion 无法找到 Qt 安装路径或 QML 导入目录，请按照以下步骤操作：

![QML 导入目录未找到警告](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qml_editorwarning.png)

1. 检查  `CMAKE_PREFIX_PATH`  是否指向 Qt 安装目录。

点击   CMake 设置   并将以下内容添加到   CMake 选项  ：

```CMAKE
-DCMAKE_PREFIX_PATH=your_qt_installation

```

例如：

![CMake 选项中的 Qt 安装路径](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_cmake_path.png)

2. 在大多数情况下，配置 CMake 足以让 CLion 检测到 Qt 和 QML 路径，但如果通知仍然存在，您可能需要手动设置路径。 点击   QML 设置   或转到  `设置 | 语言与框架 | QML`  以执行此操作。

## 已知问题和限制

QML 支持在 CLion 中目前仍在开发中。 已知问题列表包括：

* 许多标准函数和方法被高亮显示为未解析（ [CPP-31883](https://youtrack.jetbrains.com/issue/CPP-31883)）。

* QML 文件的结构视图正在改进（ [CPP-31886](https://youtrack.jetbrains.com/issue/CPP-31886)）。

* QML 的配色方案和代码样式设置正在开发中（ [CPP-30547](https://youtrack.jetbrains.com/issue/CPP-30547)）。

## See also

### 操作指南

[Qt 项目](qt-tutorial.html) [CMake 配置文件](cmake-profile.html)

