STM32 工程导入

CytStudio 的 Project Wizard 可以把你在其他 IDE 里已经建好的 STM32 工程直接迁移进来，自动提取芯片型号、源文件、包含路径、宏定义、CPU/FPU、链接脚本等配置，免去手动重建工程的重复劳动。

支持导入的格式

说明：不同来源的语法差异（如启动文件、链接脚本写法）可交给内置 AI 智能体协助修复，无需手动逐个对照。

前置准备

1. 安装 J-Link：如需下载 / 调试 / 烧录，请先安装 SEGGER J-Link 软件包（见「帮助文档 → 安装说明」）。
2. 安装工具链：确认已安装 GCC（arm-none-eabi-gcc）或直接使用 CytStudio 内置的 Clang 编译器。
3. 准备源工程：把待导入的工程文件（.ioc / .ewp / .uvprojx）及其源码放在本机可访问的目录中。

导入步骤

1. 启动 CytStudio，点击 工程 → 文件向导。
2. 在向导中选择要导入的项目文件：
   • STM32CubeMX 工程选择 .ioc 文件
   • Keil 工程选择 .uvprojx 文件
   • IAR 工程选择 .ewp 文件
3. 点击 下一步，CytStudio 会自动解析并提取：
   • 芯片型号、CPU / FPU 配置
   • 源文件目录与源码列表
   • 包含路径与宏定义
   • 链接脚本、启动 / 汇编文件
4. 在确认页逐项核对导入设置，必要时可手动增删源文件、修正路径。
5. 确认无误后点击 下一步，按向导完成导入 —— 工程会出现在左侧文件树中。

导入后的首次构建

1. 点击 工程 → 选项，核对芯片类型、构建目标与工具链是否与迁移前一致。
2. 选择工具链：CytStudio 会根据工程配置在 GCC / Clang 之间自动选择。
3. 点击 F7（增量编译）或 Ctrl + Alt + F7（重新编译全部）。
4. 构建消息以结构化方式输出（错误 / 警告 / 备注），双击即可跳转到对应代码位置。

常见问题

Q: 导入后提示“找不到源文件”？

请检查 Project Wizard 确认页中的源文件目录与包含路径是否为绝对路径，或将路径修正为当前机器上的正确位置。

Q: 迁移后编译报错？

不同 IDE 的宏定义 / 预处理稍有差异，可把错误日志交给内置 AI 智能体，它可参考工程配置自动修复并重新验证。

Q: 想导入非 STM32 的工程？

Project Wizard 同样支持其他 Cortex-M 目标，选择对应芯片型号即可。

文档持续更新中，如有疑问欢迎通过问题反馈提交！