5.1 项目结构与多项目管理

项目典型结构

ChipON VSCode Extension 创建的工程遵循标准嵌入式工程架构，典型目录与文件组织结构如下：

项目目录结构

• _config

  存放预编写的 startup 汇编与系统中断向量源代码
• .vscode

  VSCode 工作区配置与 KF32 项目核心参数
  • chipon.json

    KF32 项目专属配置文件（芯片型号、编译宏等）
  • launch.json

    VSCode GDB 在线调试会话配置
  • settings.json

    VSCode 工作区特定偏好设置
  • tasks.json

    VSCode 自定义构建与辅助任务
• cmake

  KF32 项目 CMake 构建规则配置
  • internal

    Toolchain 路径及 KF32 平台编译选项配置
  • CMakeLists.txt

    CMake 顶层工程配置文件
  • CMakePresets.json

    CMake 构建与调试扩展预设
  • configPresets.json

    用户自定义扩展预设文件
  • flags.cmake

    预定义编译参数与宏定义文件
• __Kungfu32_chipmodel_define.h

  芯片型号宏与寄存器映射头文件
• kf_it.c

  系统及外设中断服务函数实现文件
• main.c

  应用程序主程序入口文件
• xxxxx.ld

  目标芯片链接脚本（分配 FLASH/RAM 地址空间）

多项目管理

ChipON VSCode Extension 支持在同一工作区中同时显示、操作和管理多个位于不同路径的工程。

若需将外部已有工程添加到当前工作区，请按以下步骤操作：

1. 在 VSCode 资源管理器（Explorer）空白处单击鼠标右键，选择 Add Folder to Workspace...（添加文件夹到工作区）。
2. 在弹出的系统文件对话框中，浏览并选中目标工程的根目录文件夹，单击 添加 确认。
3. 添加完成后，左侧 PROJECTS 栏将同步列出所有已导入的项目。每个项目均可独立切换并执行编译、编程、调试等操作，项目配置互不干扰。