0 1前言
STM32CubeIDE for Visual Studio Code V3.8.0中提供了两项功能，使STM32用户很方便的将STM32CubeIDE工程切换到STM32CubeIDE for Visual Studio Code所支持的Cmake格式。如下是STM32CubeIDE for Visual Studio Code V3.8.0版本。
0 2 STM32CubeIDE工程的两种来源
在STM32生态系统中，快速获得STM32CubeIDE格式的工程，有两种方法。
**方法一：**使用STM32CubeMX生成一个用户工程，例如，在Toolchain/IDE时选择
注意，除非是为了测试，否则没有必要先生成STM32CubeIDE格式，再使用工具转换成CMake，因为STM32CubeMX本身支持CMake格式。
**方法二：**使用STM32Cube固件库，包含例程与驱动。STM32Cube库可以通过STM32CubeMX安装，可以通过www.st.com直接下载，也可以使用git从github.com上进行下载。通过STM32CubeMX安装的默认目录一般在C:\Users\【用户名】\STM32Cube\Repository。
STM32CubeIDE for VSCode所提供的两项菜单，就涵盖以上这两种情况。
0 3转换指定的STM32CubeIDE工程
进行转换的前提是已经安装了STM32CubeIDE for Visual Studio Code V3.8.0。否则相应的菜单也看不见。这个菜单的名字是【Convert Eclipse STM32CubeIDE project】
如果对STM32CubeIDE for VSCode不熟悉，则可以从整体界面了解该菜单的位置。
点击【Convert Eclipse STM32CubeIDE project】，会弹出选择源和目标目录的菜单。
依次选择【Project source】和【Project destination】，在弹出的对话狂选择相应的目录。【Project source】需要选择到STM32CubeIDE工程格式文件所在一级的目录。接着就会出现菜单【Convert project】。
点击【Convert project】,则会联网下载ide-project-converter，然后在本地将STM32CubeIDE转换成CMake格式。转换成CMake格式之后的操作就和从STM32CubeMX生成CMake工程进行导入所需要的步骤是一样的了，无需在本文多讲。
0 4选择STM32Cube例程进行转换
例程浏览并转换的菜单是【Import STM32Cube example(s)】
点击该菜单，就会自动搜索仓库中的所有例程，例如：
但搜索整个仓库耗时太长，并不是我们所想要的。如果你的仓库包含的产品很少，则可以继续此默认行为。这个时候，技巧性的做法是选择单一仓库。使用右侧的【Browser folder on local disk】
将其选择成某个STM32产品系列，例如C:\Users\zhangr\STM32Cube\Repository\STM32Cube_FW_U3_V1.3.0
则例程搜索很快就会完成，如下。
这个时候，我们就可以输入关键字进行过滤，例如，我们在【name】中输入【gpio】，则例程范围会进一步缩小。
直接选择右侧按钮【Import】。
转换过程中会联网下载ide-project-converter，然后在本地进行转换。转换之后的操作就和从文件夹中导入CMake工程是一样的了。
0 5 注意事项
在整个操作过程中，注意STM32CubeIDE for Visual Studio Code需要你能进行联网下载。如果【STM32Cube Bunder Manager】为空，则请先新建一个目录，然后使用STM32CubeIDE for Visual Studio Code打开之后再进行转换操作。这个目录可用于存放转换后的工程。否则，可能会出现无法下载ide-project-converter。也就是如下操作会失败。
0 6 总结
总体而言，STM32CubeIDE for Visual Studio Code已提供将STM32CubeIDE工程转换为CMake工程的能力，便于用户在Visual Studio Code环境中继续进行软件开发。
点击下载《转换STM32CubeIDE工程到STM32CubeIDE for Visual Studio Code》原文档。
重要通知 - 请仔细阅读
意法半导体公司及其子公司 （"ST"）保留随时对 ST 产品和 / 或本文档进行变更的权利，恕不另行通知。买方在订货之前应获取关于 ST 产 品的最新信息。 ST 产品的销售依照订单确认时的相关 ST 销售条款。 买方自行负责对 ST 产品的选择和使用， ST 概不承担与应用协助或买方产品设计相关的任何责任。 ST 不对任何知识产权进行任何明示或默示的授权或许可。 转售的 ST 产品如有不同于此处提供的信息的规定，将导致 ST 针对该产品授予的任何保证失效。 ST 和 ST 徽标是 ST 的商标。若需 ST 商标的更多信息，请参考 www.st.com/trademarks。所有其他产品或服务名称均为其 各自所有者的财 产。 本文档是ST中国本地团队的技术性文章，旨在交流与分享，并期望借此给予客户产品应用上足够的帮助或提醒。若文中内容存有局限或与ST 官网资料不一致，请以实际应用验证结果和ST官网最新发布的内容为准。您拥有完全自主权是否采纳本文档（包括代码，电路图 等）信息， 我们也不承担因使用或采纳本文档内容而导致的任何风险。 本文档中的信息取代本文档所有早期版本中提供的信息。 © 2020 STMicroelectronics - 保留所有权利