oh-my-telinkiot

将 Telink IoT Studio 的 headless 构建集成到 VS Code 中，支持项目选择、构建配置、Build/Clean，以及实时的编译器诊断输出。提供与 Eclipse 一致的构建设置面板和 IntelliSense 集成。

前置条件

• VS Code >= 1.74.0
• Telink IoT Studio 已安装（本地或远程服务器）

安装

从 VS Code 插件商店安装（推荐）

1. 在 VS Code 中按 Ctrl+Shift+X 打开扩展面板
2. 搜索 oh-my-telinkiot
3. 点击 Install 安装

安装后会自动接收更新。如需检查更新，点击扩展面板右上角的 ... → Check for Extension Updates。

从 VSIX 离线安装

1. 在 Releases 中下载最新 .vsix 文件
2. 在 VS Code 中按 Ctrl+Shift+P，输入 Install from VSIX
3. 选择下载的 .vsix 文件

配置

打开设置：Ctrl+, → 搜索 Telink Build（如果使用ssh连接服务器的话，选择Remote那一栏）

典型配置示例

Linux 远程服务器：

{
    "telinkBuild.idePath": "/usr/local/TelinkIoTStudio"
}

Windows 本地：

{
    "telinkBuild.idePath": "C:\\TelinkIoTStudio"
}

关于多机器隔离

所有配置项使用 machine 作用域，不会通过 Settings Sync 同步。本地 Windows 和远程 Linux 需要分别配置各自的 idePath。

此外，插件内置了平台校验 — 如果在 Linux 上检测到 Windows 路径（或反之），会自动回退到默认值，防止跨平台路径误用。

使用

状态栏按钮

当工作区中包含 .cproject 文件时，插件在状态栏左侧显示以下按钮：

按钮始终分组显示，不会被其他插件的按钮分隔。构建或清理过程中，对应按钮变为红色 Stop 按钮，其余按钮暂时禁用。

命令面板

按 Ctrl+Shift+P，搜索 Telink：

构建流程

1. 打开包含 .cproject 文件的工作区
2. 点击状态栏的 Telink: No Project 选择项目
3. 点击 No Config 选择构建配置（如果只有一个配置会自动选择）
4. 点击 Build 开始构建

构建会自动保存所有未保存的文件，然后启动编译。构建过程中终端在后台更新日志。

构建日志输出在 Telink Build 终端中，编译错误和警告会同步显示在 VS Code 的 Problems 面板中，点击终端中的错误链接可以直接跳转到对应源码位置。

构建设置面板

点击状态栏的 Settings 按钮（或执行 Telink: Edit Build Settings），可以可视化编辑当前构建配置的编译器参数。

设置面板采用与 Eclipse 一致的树形导航结构，覆盖所有 20+ 个设置子页面和编译选项：

• Target Processor — Architecture、Floating point、ABI、Code model（含 Telink 自定义选项）、MCU 型号等
• Optimization — 9 级优化（含 Telink 自定义 -Os1/-Os2）、Debug level、Debug format
• Warnings — 各类编译器警告开关
• GNU RISC-V Cross Assembler — Preprocessor、Includes、Warnings、Miscellaneous
• GNU RISC-V Cross C Compiler — Preprocessor、Optimization、Warnings、Miscellaneous
• GNU RISC-V Cross C Linker — General、Libraries、Miscellaneous
• GNU RISC-V Cross Create Flash Image — Output format、Section 过滤
• GNU RISC-V Cross Create Listing — 各种反汇编和符号选项
• GNU RISC-V Cross Print Size — Size 输出格式
• Build Steps — Pre-build / Post-build 步骤
• Source Excludes — 编辑 .cproject 中 <sourceEntries> 的 excluding 路径，一行一个路径

此外，设置面板还支持直接管理构建配置（Target）：

• New Target — 基于现有配置克隆一个新的 Target
• Delete Targets — 批量删除不需要的 Target

支持在多个编译配置之间快速切换，搜索过滤选项，以及 Apply / Cancel 操作。

修改 Source Excludes 后点击 Apply，VS Code 文件浏览器中的隐藏状态会立即刷新，不需要再手动切换一次编译配置。

点击顶级工具节点（如 Assembler、Compiler）时会显示其所有子选项的只读摘要。

IntelliSense 集成

插件自动将当前编译配置的宏定义（-D）和头文件搜索路径（-I）提供给 VS Code 的 C/C++ 扩展（ms-vscode.cpptools），实现：

• 宏定义自动生效，代码中的条件编译分支正确高亮
• 头文件路径自动解析，#include 不再报错
• Eclipse 虚拟路径（${workspace_loc}、${ProjName}、${eclipse_home}）和 .project 中的 linkedResources 自动转换为真实文件系统路径

切换编译配置或修改设置后，IntelliSense 自动更新，无需手动配置 c_cpp_properties.json。

前提：需要安装 C/C++ 扩展（ms-vscode.cpptools）。

自动隐藏排除文件（实验性）

开启 telinkBuild.autoExclude 后，插件会自动解析 .cproject 中的 <sourceEntries> 排除列表，将对应的文件和文件夹从 VS Code 文件浏览器中隐藏。切换配置、切换项目，或在设置面板中修改 Source Excludes 并点击 Apply 后，隐藏状态都会自动刷新。

插件通过解析 .project 文件中的 linkedResources 将 Eclipse 虚拟路径映射为真实文件系统路径，支持 PARENT-N-PROJECT_LOC 等变量。

隐藏未导入文件（实验性）

开启 telinkBuild.hideUnimported 后，选择编译配置时插件会自动识别 Eclipse 项目中未导入的文件和文件夹并将其隐藏。具体逻辑：

• 解析 .project 文件中的 linkedResources，确定所有被 Eclipse 引用的真实路径
• 递归检查每个被引用目录下的子目录，隐藏未被引用的子文件夹
• 例如：磁盘上有 49 个 demo 目录，但当前 .project 只链接了 37 个，未链接的 12 个会被隐藏

重启 VS Code 后所有隐藏会自动清除，重新显示所有文件。

提示：被隐藏的文件默认不会出现在 VS Code 搜索结果中。如需搜索隐藏文件，点击搜索框右侧的齿轮图标，关闭 "Use Exclude Settings and Ignore Files" 选项即可。

开发

# 编译
npm run compile

# 监听模式（自动重编译）
npm run watch

# 打包 .vsix
npx @vscode/vsce package --allow-missing-repository

常见问题

Q: 构建报错 spawn ... ENOENT？

A: 检查 telinkBuild.idePath 是否正确指向了 Telink IoT Studio 的安装目录，且该目录下的可执行文件存在。

Q: 本地和远程的 idePath 互相影响？

A: 不会。所有配置使用 machine 作用域，且插件内置平台校验，自动拒绝不匹配当前平台的路径。

Q: 状态栏按钮被其他插件隔开了？

A: 插件使用紧凑的小数优先级保证按钮始终相邻。如果仍有问题，尝试隐藏不需要的状态栏项目。

Q: 编译时终端一直抢占焦点，无法在编辑器中操作？

A: 已修复。构建终端在后台更新日志，不会抢占焦点。

Q: 打开工作区后看不到状态栏按钮？

A: 只有当工作区中包含 .cproject 文件时才会显示按钮。确认当前打开的工作区是否包含 Telink 项目。

Q: IntelliSense 不生效？

A: 确保已安装 C/C++ 扩展（ms-vscode.cpptools）。插件切换编译配置后会自动推送宏和头文件路径。可在 Output 面板选择 "Telink IntelliSense" 查看详细日志。