衡山派D133EBS开发板Windows环境搭建指南：基于VSCode与Git的SDK获取与配置

衡山派D133EBS开发板Windows环境搭建指南基于VSCode与Git的SDK获取与配置最近有不少刚拿到衡山派D133EBS开发板的朋友问我第一步该做什么我的回答总是先把开发环境搭起来。一个顺手的开发环境就像战士手里的枪是后续所有开发工作的基础。今天我就手把手带大家在Windows系统上用最主流的VSCode和Git把衡山派的开发环境给配好。整个过程不复杂跟着我的步骤走半小时内就能搞定为后续的模块移植和代码开发铺平道路。1. 为什么选择这套工具链在开始动手之前咱们先简单聊聊为什么选VSCode和Git。衡山派官方提供了多种开发环境选项包括Ubuntu。但对于大多数从单片机转过来或者习惯了Windows的开发者来说在Windows下开发门槛更低工具也更丰富。VSCode微软出品的免费、开源代码编辑器。它轻量、速度快通过安装插件可以变得无比强大几乎能胜任任何语言的开发对C/C的支持尤其出色。用它来编辑衡山派的SDK代码体验非常流畅。Git这是一个版本控制系统你可以把它理解成一个“代码时光机”。咱们开发中经常要修改代码Git能详细记录每一次修改的内容、时间和作者。万一改错了可以轻松回退到之前的任何一个版本再也不用担心代码改崩了找不回来。更重要的是衡山派的官方SDK代码库就是用Git管理的我们必须用它来“下载”更准确的说法是“克隆”最新的代码。简单来说Git负责把代码从云端“搬”到你的电脑上VSCode负责让你舒舒服服地阅读和修改这些代码。接下来咱们就一步步把它们装好、配置好。2. 安装Git获取SDK的钥匙首先咱们来安装Git。这是获取衡山派SDK的必经之路。2.1 下载Git安装包打开Git的官方网站https://git-scm.com/downloads。页面会自动检测你的系统通常直接会显示“Download for Windows”。点击这个按钮下载最新的Windows安装程序比如Git-2.47.0-64-bit.exe。2.2 详细安装步骤与配置双击下载好的安装包咱们开始安装。安装过程中有几个选项需要注意我会一一说明。许可声明 (License)直接点击Next即可。安装路径 (Select Destination Location)点击Browse…可以更改安装目录。重要提示尽量不要安装在C盘系统盘也绝对不要使用包含中文或空格的路径。比如D:\Development\Git就是一个不错的选择。选好后点击Next。注意养成好习惯开发相关的软件和项目都不要放在C盘或中文路径下能避免很多莫名其妙的错误。选择组件 (Select Components)保持默认勾选即可点击Next。选择默认编辑器 (Choosing the default editor used by Git)这里选择Git自带的Vim作为默认编辑器。对于初学者我们主要用Git来克隆代码很少直接在这里编辑所以选默认的Vim就行。点击Next。调整PATH环境 (Adjusting your PATH environment)这是非常关键的一步请选择第二项Git from the command line and also from 3rd-party software(从命令行以及第三方软件中使用Git)这个选项会把Git的一些核心命令添加到系统的PATH环境变量里。这样你不仅能在Git自带的命令行Git Bash里使用Git也能在Windows自带的命令提示符CMD或PowerShell里使用未来VSCode的终端也能直接调用Git命令。点击Next。选择HTTPS传输后端 (Choosing HTTPS transport backend)选择使用OpenSSL library。这是安全传输的库保持默认。点击Next。配置行尾符号转换 (Configuring the line ending conversions)这个选项关系到文本文件换行符的处理。Windows和Unix/Linux系统的换行符标准不同。为了兼容性我们选择默认的第一项Checkout Windows-style, commit Unix-style line endings(签出Windows样式提交Unix样式的行结尾)这样从代码库拉取代码到Windows电脑时Git会自动转换换行符为Windows格式当你提交代码时它又会转换回Unix格式保证代码库的统一。点击Next。配置终端模拟器 (Configuring the terminal emulator)选择第一个选项使用Git自带的MinTTY作为终端。点击Next。选择git pull行为 (Choose the default behavior ofgit pull)选择第一个选项Fast-forward or merge。这是最常用的合并策略。点击Next。选择凭证助手 (Choose a credential helper)选择Git Credential Manager。这个工具会帮你安全地保存访问Git仓库比如Gitee、GitHub的用户名和密码下次就不用重复输入了。点击Next。其他选项后续的几个选项关于文件系统缓存、实验性功能等全部保持默认即可一路点击Next直到出现Install按钮点击开始安装。完成安装安装完成后勾选Launch Git Bash可以立即打开Git命令行试试然后点击Finish。安装完成后你可以在开始菜单找到Git文件夹里面会有Git Bash一个命令行工具。不过别急我们暂时不需要直接操作它因为接下来配置VSCode后在VSCode里就能直接使用Git命令了。3. 安装与配置VSCode你的代码工作站Git帮我们拿到了代码现在需要一个强大的编辑器来阅读和编写它们。VSCode就是我们的不二之选。3.1 下载与安装VSCode打开VSCode官网https://code.visualstudio.com/download。点击大大的Windows按钮下载安装包通常是VSCodeUserSetup-x64-xxx.exe。双击运行安装包。同意协议点击“我同意”。选择安装位置同样建议更改到非系统盘、无中文的路径例如D:\Development\VSCode。选择开始菜单文件夹默认即可。选择附加任务这个页面很重要建议勾选以下选项它们能极大方便后续使用创建桌面快捷方式将“通过Code打开”操作添加到Windows资源管理器文件上下文菜单这样你可以在任何文件夹上右键选择用VSCode打开整个文件夹将“通过Code打开”操作添加到Windows资源管理器目录上下文菜单将Code注册为受支持的文件类型的编辑器添加到PATH重启后生效务必勾选这能让你在系统的任何命令行里直接用code .命令打开当前文件夹点击下一步然后安装。安装完成后可以直接点击完成运行VSCode。3.2 安装必备插件汉化与C/C支持第一次打开VSCode界面是英文的。别担心咱们通过安装插件来让它变得更顺手。3.2.1 安装中文语言包在VSCode左侧活动栏找到并点击扩展图标或者按CtrlShiftX。在扩展市场的搜索框中输入Chinese (Simplified) Language Pack for Visual Studio Code。在搜索结果中找到由Microsoft发布的中文语言包点击Install按钮进行安装。安装完成后VSCode右下角会弹出一个提示框让你重启Restart以启用语言包。点击Restart。重启后界面应该就变成中文了。如果没变可以手动切换按CtrlShiftP打开命令面板。输入Configure Display Language并选择它。在弹出的列表中选择中文(简体)然后根据提示重启VSCode。3.2.2 安装C/C扩展这是为衡山派C语言开发提供智能提示、代码跳转、语法高亮等核心功能的插件。再次打开扩展视图左侧扩展图标。在搜索框输入C/C。找到由Microsoft发布的C/C扩展图标是一个蓝色的“∞”符号点击安装。安装这个扩展后当你打开C或C文件时VSCode就能提供代码自动补全、函数定义跳转按住Ctrl点击函数名、语法错误检查等强大功能了。对于衡山派SDK开发这个插件是必需品。提示目前我们只需要这个插件的基础功能。后续如果需要编译代码可能还需要配置编译器路径但那属于交叉编译工具链的配置我们会在获取SDK后的教程中详细说明。现在插件安装好就能用了。4. 下一步做什么好了到这里咱们的Windows基础开发环境就搭建完毕了。总结一下我们完成了两件大事安装了Git学会了如何正确配置安装选项特别是PATH环境变量为后续命令行操作和VSCode集成打下了基础。安装并汉化了VSCode配置了强大的代码编辑环境并安装了核心的C/C开发插件。环境搭好工具就位。接下来你就可以用Git命令去克隆衡山派的官方SDK代码库了。通常命令类似这样具体仓库地址请参考衡山派官方文档git clone https://gitee.com/xxx/hengshanpai-sdk.git克隆完成后在VSCode中点击文件 - 打开文件夹选择你克隆下来的SDK目录就能开始畅游代码的海洋进行模块移植和功能开发了。关于SDK的具体编译和烧录我们留到下一篇教程再详细展开。如果安装过程中遇到任何问题欢迎随时交流讨论。