RDK Studio 代码编辑器

开发与问题 应用开发
, ,
2

你好！关于 RDK Studio 内置代码编辑器 Ctrl + 鼠标点击跳转函数 失效的问题，这通常是因为代码索引（IntelliSense）未建立或项目路径未正确识别。

RDK Studio 内置的编辑器基于 Web 版 VS Code (Monaco Editor)，其跳转功能依赖于后台的 C/C++ 语言服务器（cpptools）对代码的索引。

核心原因与解决方案

1. 确认项目已正确“打开”而非仅“浏览”

在 RDK Studio 的文件管理器中，仅仅点击文件预览是无法建立完整索引的。

  • 操作步骤：
    1. 在 RDK Studio 左侧栏点击 Files (文件管理)。
    2. 找到你的代码根目录文件夹（包含 CMakeLists.txt 或 package.xml 的目录）。
    3. 右键点击该文件夹，选择 “Open in VS Code” (如果已配置远程) 或在内置编辑器中确保你是通过 “Open Folder” 的方式加载的，而不是单个文件。
    4. 等待索引完成：打开后，观察编辑器右下角是否有类似 Parsing... 或 Loading... 的提示。在索引完成前，跳转功能不可用。

2. 检查 C/C++ 配置 (c_cpp_properties.json)

如果索引已完成但仍无法跳转，可能是头文件路径未包含。

  • 操作步骤：
    1. 在编辑器中按 F1 或 Ctrl+Shift+P，输入 C/C++: Edit Configurations (UI)。
    2. 检查 Include path 是否包含了你的 ROS 工作空间路径（如 /home/sunrise/my_ws/src）以及系统路径（如 /opt/ros/noetic/include）。
    3. 如果不确定，可以尝试将 compilerPath 设置为板载的 gcc 路径（例如 /usr/bin/aarch64-linux-gnu-gcc），这有助于自动推导包含路径。

3. 推荐方案：使用本地 VS Code 远程连接 (最稳定)

RDK Studio 的网页版编辑器功能受限（受限于浏览器性能和后端服务），强烈建议使用本地安装的 VS Code 通过 SSH 连接开发板，体验与本地开发一致（包括完美的 Ctrl+ 跳转）。

  • 操作步骤：
    1. 本地安装：在电脑上安装 VS Code 和 Remote - SSH 插件。
    2. 连接设备：
      • 确保电脑与 RDK X5 网络互通。
      • VS Code 左下角点击绿色图标 → Connect to Host → Add New SSH Host。
      • 输入命令：ssh sunrise@<你的开发板IP> (默认用户通常是 sunrise)。
      • 输入密码（默认通常是 sunrise 或你修改后的密码）。
    3. 打开文件夹：连接成功后，点击 Open Folder，选择开发板上的代码目录。
    4. 自动索引：VS Code 会在后台自动下载 C/C++ 插件到开发板并建立索引，此时 Ctrl + 鼠标点击 即可完美跳转。

排查清单

如果坚持使用 RDK Studio 内置编辑器，请按以下顺序排查：

  1. 等待：打开大项目后，是否等待了至少 1-2 分钟让后台建立索引？
  2. 文件类型：确认是 .cpp / .h / .py 文件（Python 需要 Pylance 支持，C++ 需要 cpptools）。
  3. 浏览器兼容性：尝试更换 Chrome 或 Edge 浏览器，某些浏览器插件可能拦截快捷键。
  4. 重启服务：在 RDK Studio 的 Terminal 中重启代码服务（如果有相关命令），或者直接刷新页面重新加载项目。

建议：如果是进行复杂的代码开发，本地 VS Code + Remote SSH 是官方和社区最推荐的开发方式，能避免大部分 Web 编辑器的功能限制。

你可以参考社区已有的连接教程：