> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 已知问题

> Qualcomm® VSCode 扩展的当前限制和变通方案。

下表列出了当前版本已确认的问题及推荐的变通方案。

| 问题 | 变通方案 |
| - | - |
| IDE 不会下载 YOLO 模型 | 手动将其下载到目标设备上的 `/etc/models` |
| 扩展无法与 Ubuntu 上的 VS Code **Snap** 包一起工作 | 安装 `.deb` 包 — 参阅[在 Ubuntu 上安装 VS Code](../setup/install-vscode) |
| 开发套件出厂时可能带有过时的固件 | 使用[入门向导](../quick-start)烧录最新镜像 |
| 烧录后初始化脚本不会自动运行 | 烧录后，运行 **Dashboard → SDK → Configure Device** |
| 使用 QLI 1.3 或更早版本的 Rubik Pi 需要额外的 UFS 配置 | 在使用扩展之前，在 IDE **之外**完成 UFS 配置步骤 |
| macOS / UTM 环境测试有限 | 为获得最佳体验，请使用 Ubuntu 22.04 或 Windows + WSL |
| Ubuntu 24.04 主机测试有限 | Ubuntu 22.04 是推荐且经过完整测试的主机 |

<Note>
  对于 Qualcomm Linux 软件版本 **1.3 或更早**的设备，需要在 IDE 之外执行额外的 UFS 配置和 CDT 编程步骤。有关这些步骤，请参阅 [Qualcomm Developer 文档](https://developer.qualcomm.com)。
</Note>