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

# 常见问题

> 针对 Qualcomm® VSCode 扩展最常见问题的解答。

<AccordionGroup>
  <Accordion title="我无法将 USB 设备连接到 WSL" icon="usb">
    \*\*原因：\*\*部分组织通过组策略阻止 `usbipd` — 这通常表现为 `usbipd bind` 或 `usbipd attach` 期间出错。

    \*\*解决方法：\*\*联系您的 IT 部门，请他们在您的机器上放行 `usbipd` 组策略。

    作为替代方案，可尝试[镜像网络变通方法](../setup/wsl-usb#corporate-firewall-workaround)。
  </Accordion>

  <Accordion title="我无法向设备烧录镜像" icon="bolt">
    \*\*检查 1：\*\*确认设备处于 EDL 模式。

    ```bash theme={null}
    lsusb
    ```

    您应该看到：

    ```text theme={null}
    Bus 002 Device 002: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
    ```

    如果设备未出现，请重新上电后重试。
  </Accordion>

  <Accordion title="设备在 lsusb 中显示，但 QDL 报告权限错误" icon="lock">
    \*\*原因：\*\*您的用户账户不是 `plugdev` 组的成员。

    **解决方法：**

    ```bash theme={null}
    sudo usermod -aG plugdev $USER
    ```

    注销后重新登录。详细说明请参阅 [Android 开发者指南](https://developer.android.com/studio/run/device)。

    另外请确认您的 [udev 规则](../setup/udev-rules)配置正确。
  </Accordion>

  <Accordion title="入门向导期间主机环境设置失败" icon="wrench">
    **最可能的原因：**

    1. **缺少 sudo 密码** — VS Code 终端正在等待您输入密码。如果终端面板被隐藏，请通过 **View → Terminal** 打开。

    2. **APT GPG 签名冲突** — 少数用户会遇到类似如下的错误：

    ```text theme={null}
    Conflicting values set for option Signed-By regarding source
    ```

    这与 [这篇 AskUbuntu 帖子](https://askubuntu.com/questions/1156409/conflicting-values-set-for-option-signed-by-regarding-source)中描述的问题相同。删除包含冲突 GPG 资源的其中一个文件即可修复。
  </Accordion>

  <Accordion title="安装后 VS Code 扩展图标不见了" icon="puzzle-piece">
    1. 确认扩展已成功安装：打开扩展面板，在已安装列表中查找 **Qualcomm IDE**。
    2. 重新加载 VS Code 窗口：`Ctrl+Shift+P` → **Developer: Reload Window**。
    3. 如果您使用 Windows，请确认 VS Code 已连接到 WSL 运行（状态栏应显示 **WSL: Ubuntu-22.04**），并在 WSL 内重新安装。
  </Accordion>

  <Accordion title="我的项目中 IntelliSense 不工作" icon="code">
    自动生成的 `.vscode/c_cpp_properties.json` 可能指向了过期的 SDK 路径。

    1. 打开命令面板（`Ctrl+Shift+P`）。
    2. 运行 **C/C++: Edit Configurations (UI)**。
    3. 确认包含路径指向您已安装的 SDK。

    或者，删除 `.vscode/` 文件夹并从 **Projects** 部分重新导入项目以重新生成它。
  </Accordion>
</AccordionGroup>

***

仍未解决？请访问 [Qualcomm 开发者论坛](https://developer.qualcomm.com/forum)或查看 [VS Code 常见问题](https://code.visualstudio.com/docs/supporting/faq)。