【腾讯位置服务征文大赛】环境搭建篇 —— 基于 CodeBuddy 从零配置开发环境目 录【腾讯位置服务征文大赛】环境搭建篇 —— 基于 CodeBuddy 从零配置开发环境前 言1 为什么推荐新手用 CodeBuddy 做腾讯 LBS 开发2 CodeBuddy IDE 下载与安装Windows 系统全流程3 CodeBuddy 初始化与账号登录4 腾讯位置服务官方 Skill 资源包获取5 在 CodeBuddy 中导入腾讯地图官方 Skill 技能包6 新手避坑指南导入 Skill 常见问题解决7 本章小结前 言这是一篇面向新手的「CodeBuddy 通用开发环境搭建教程」全程零门槛不用配置复杂的本地开发环境跟着步骤走就能完成云端 IDE 的安装、登录以及腾讯位置服务开发所需的技能包导入为后续任何 LBS 相关项目开发打好基础。1 为什么推荐新手用 CodeBuddy 做腾讯 LBS 开发在正式开始安装前先简单说说为什么选择 CodeBuddy零本地环境配置自带云端开发环境不用安装复杂的编译器、依赖库打开就能写代码AI 辅助开发内置 AI 助手能帮你写代码、改 bug、解释腾讯地图 API 文档新手友好度拉满官方 Skill 支持可直接集成腾讯位置服务的官方 Skill 技能包不用自己找 SDK、配置鉴权一键导入就能用多端适配支持 Windows、Mac 系统还有网页版和客户端随时随地都能开发2 CodeBuddy IDE 下载与安装Windows 系统全流程下面开始手把手带你完成 CodeBuddy 的安装全程 9 个步骤每一步都有截图对应跟着操作就行。步骤 1进入官网下载 CodeBuddy IDE首先打开 CodeBuddy 官方网站点击页面右上角的「下载」按钮在下拉菜单中选择「CodeBuddy IDE」进入下载页面。步骤 2双击安装包启动安装向导下载完成后找到安装包文件格式为.exe文件名类似CodeBuddy-win32-x64-user-xxx.exe双击运行启动安装向导。步骤 3同意许可协议继续安装进入安装向导后首先会显示许可协议勾选「我同意此协议 (A)」然后点击「下一步 (N)」按钮继续安装流程。 说明这里的协议包含 CodeBuddy 的服务条款和隐私政策建议快速浏览确认无问题后再勾选同意。步骤 4自定义安装路径新手必看接下来是安装路径设置界面默认路径通常在 C 盘这里建议修改到 D 盘或其他非系统盘避免后续 C 盘空间不足影响软件运行。可以直接修改路径文本框也可以点击「浏览 (R)...」按钮选择自定义的安装文件夹确认路径后点击「下一步 (N)」❌ 避坑提示不要安装在中文路径下比如D:\编程工具\CodeBuddy部分软件对中文路径支持不佳可能导致后续功能异常建议用纯英文路径比如D:\Tools\CodeBuddy CN。步骤 5设置开始菜单文件夹这一步是设置程序快捷方式在开始菜单中的显示名称保持默认的「CodeBuddy CN」即可也可以自定义修改然后点击「下一步 (N)」。 小技巧如果不想在开始菜单创建快捷方式可以勾选左下角的「不创建开始菜单文件夹 (D)」后续直接用桌面快捷方式打开即可。步骤 6配置附加任务选项接下来是附加任务设置界面这里的选项建议按默认勾选新手不用额外修改「将 CodeBuddy CN 注册为受支持的文件类型的编辑器」关联代码文件双击就能用 CodeBuddy 打开「添加 buddy 命令到 PATH重启后生效」后续可以在 CMD 中直接调用 buddy 命令开发更方便确认选项后点击「下一步 (N)」。 补充如果需要桌面快捷方式可以勾选「创建桌面快捷方式 (D)」后续打开软件更方便。步骤 7确认安装配置准备安装进入「准备安装」界面这里会显示你之前设置的所有配置信息包括安装路径、开始菜单文件夹、附加任务等确认无误后点击「安装 (I)」按钮开始安装。⚠️ 检查点这里一定要核对安装路径避免误装到 C 盘如果需要修改点击「上一步 (B)」返回修改即可。步骤 8等待安装进度完成安装程序会自动解压文件并安装 CodeBuddy界面会显示安装进度条耐心等待即可一般 1-2 分钟就能完成。 注意安装过程中不要关闭窗口或断网避免安装包损坏导致软件无法正常启动。步骤 9安装完成启动 CodeBuddy安装完成后会显示「CodeBuddy CN 安装完成」界面默认勾选「运行 CodeBuddy CN」点击「完成 (F)」按钮即可直接启动软件开始使用 恭喜到这里CodeBuddy 的安装流程就全部完成了接下来我们就可以进入软件进行账号登录和后续的腾讯 LBS 开发配置啦。3 CodeBuddy 初始化与账号登录安装完成后我们将进入软件的初始化引导流程设置界面风格、完成账号登录为后续开发做好准备。步骤 1启动软件进入欢迎界面首次启动 CodeBuddy会进入欢迎界面点击「开始使用」按钮进入初始化引导流程。步骤 2选择界面风格与语言接下来可以选择你喜欢的界面风格推荐选择「深色」模式长时间写代码更护眼语言默认是「中文简体」确认后点击「继续」。 提示界面风格后续也可以通过设置菜单修改不用担心选错。步骤 3跳过配置导入如果之前没有使用过 VS Code、Cursor 等编辑器可以直接点击「跳过」按钮无需导入配置直接使用默认设置即可。步骤 4进入登录引导界面完成初始化引导后会显示「一切准备就绪」界面点击「登录」按钮进入账号登录流程。步骤 5扫码登录 CodeBuddy 账号登录界面支持微信扫码登录勾选「我已阅读并同意《服务条款》和《隐私协议》」然后用微信扫描二维码即可登录。步骤 6登录成功进入主界面扫码登录成功后会显示「登录成功」提示返回 IDE 继续使用即可进入 CodeBuddy 的主界面。步骤 7CodeBuddy 主界面预览登录后我们就能看到 CodeBuddy 的主界面了左侧是文件管理、插件市场等功能菜单中间是欢迎页支持「新建文件夹」、「打开文件夹」、「克隆 Git 仓库」三种方式创建项目界面布局和 VS Code 非常相似上手零门槛。4 腾讯位置服务官方 Skill 资源包获取为了让 CodeBuddy 能直接支持腾讯地图开发我们需要先下载腾讯位置服务提供的官方 Skill 技能包这些技能包包含了地图初始化、POI 搜索、路线规划等常用接口的封装导入后 AI 就能自动调用相关能力。步骤 1进入腾讯位置服务 Skill 下载页面打开腾讯位置服务官网进入「开发文档」→「Agent Skills」→「地图技能」→「基础能力 Skill」页面这里提供了三个核心技能包的下载地址TencentMap_jsapi_skills前端地图开发技能支持地图初始化、3D 视图控制、覆盖物绘制等TencentMap_lbs_skillsLBS 综合服务技能支持周边搜索、旅游规划、轨迹可视化等TencentMap_webservice_skillsWebserviceAPI 服务技能支持地址转换、POI 搜索、路线规划等点击右侧的下载链接把三个技能包全部下载到本地。步骤 2保存下载的 Skill 压缩包下载完成后你会得到三个.zip格式的压缩包建议统一保存到一个文件夹中比如D:\TencentMap_skills方便后续导入。步骤 3解压 Skill 压缩包将三个压缩包全部解压解压后的文件夹就是后续需要导入 CodeBuddy 的 Skill 文件建议解压到D:\codebuddy\skills目录下方便管理。5 在 CodeBuddy 中导入腾讯地图官方 Skill 技能包拿到解压后的腾讯地图 Skill 文件后我们就可以把它们导入到 CodeBuddy 中让 AI 助手获得腾讯地图开发的专属能力后续就能直接用自然语言生成地图项目代码了。步骤 0确认需要导入的 Skill 文件夹解压后的三个 Skill 包每个包的核心文件夹结构如下我们后续导入的就是这些文件夹TencentMap_jsapi_skills-main→tencentmap-jsapi-gl-skill前端地图渲染核心技能TencentMap_lbs_skills-main→tencentmap-lbs-skillLBS 位置服务技能TencentMap_webservice_skills-main→ 外层文件夹注意这个导入方式特殊后面会说明步骤 1打开 CodeBuddy 设置面板启动 CodeBuddy 后点击界面右上角的「设置」图标打开设置面板。步骤 2进入「技能」管理界面在设置面板中切换到「技能」标签页然后选择「用户 Skill」标签点击右上角的「导入 Skill」按钮开始导入技能包。步骤 3导入第一个核心 Skilltencentmap-jsapi-gl-skill在弹出的文件选择窗口中找到解压后的tencentmap-jsapi-gl-skill文件夹选中后点击「选择 Skill 文件夹」按钮完成导入。导入成功后你会在「用户 Skill」列表中看到这个技能包开关默认是开启状态。步骤 4导入第二个核心 Skilltencentmap-lbs-skill用同样的方法导入tencentmap-lbs-skill文件夹再次点击「导入 Skill」按钮找到解压后的tencentmap-lbs-skill文件夹点击「选择 Skill 文件夹」导入成功后界面左下角会弹出「Skill 文件夹 tencentmap-lbs-skill 导入成功」的提示。步骤 5导入第三个核心 Skilltencent-lbs-webservice这个技能包的导入方式和前两个不同需要直接选中解压后的外层文件夹TencentMap_webservice_skills-main而不是子文件夹点击「导入 Skill」按钮找到解压后的TencentMap_webservice_skills-main文件夹直接选中它点击「选择 Skill 文件夹」导入成功后列表中会显示tencent-lbs-webservice技能包。步骤 6确认所有 Skill 导入成功三个技能包都导入完成后在「用户 Skill」列表中可以看到三个技能包全部处于开启状态开关为紫色说明导入成功。步骤 7进入工作模式准备开发导入完成后返回 CodeBuddy 主界面点击「开始工作」按钮进入开发模式至此我们的腾讯地图开发环境就全部搭建完成了6 新手避坑指南导入 Skill 常见问题解决这里整理了几个新手导入 Skill 时的高频问题帮你一次性排雷导入失败提示 “无效的 Skill 文件夹”❌ 错误原因直接导入了.zip压缩包或者选错了文件夹路径✅ 解决方法先解压压缩包导入解压后的 Skill 文件夹确认文件夹内包含skill.json等配置文件导入成功后AI 无法调用腾讯地图能力❌ 错误原因技能包的开关没有开启或者导入路径包含中文✅ 解决方法确认列表中三个技能包的开关都是开启状态同时避免使用中文路径存放 Skill 文件tencent-lbs-webservice导入失败❌ 错误原因和前两个一样导入了子文件夹✅ 解决方法必须直接选中外层的TencentMap_webservice_skills-main文件夹导入不能进入子文件夹选择7 本章小结到这里我们的CodeBuddy 腾讯 LBS 开发环境搭建篇就全部完成了✅ 成功下载并安装了 CodeBuddy IDE✅ 完成了软件初始化、账号登录和界面设置✅ 下载并解压了腾讯位置服务官方的三个核心 Skill 包✅ 成功将所有 Skill 导入到 CodeBuddy 中开启了 AI 地图开发能力现在你已经拥有了零配置的腾讯地图开发环境接下来就可以直接用自然语言让 AI 帮你生成地图项目代码了
【腾讯位置服务征文大赛】环境搭建篇 —— 基于 CodeBuddy 从零配置开发环境
发布时间:2026/6/11 7:47:22
【腾讯位置服务征文大赛】环境搭建篇 —— 基于 CodeBuddy 从零配置开发环境目 录【腾讯位置服务征文大赛】环境搭建篇 —— 基于 CodeBuddy 从零配置开发环境前 言1 为什么推荐新手用 CodeBuddy 做腾讯 LBS 开发2 CodeBuddy IDE 下载与安装Windows 系统全流程3 CodeBuddy 初始化与账号登录4 腾讯位置服务官方 Skill 资源包获取5 在 CodeBuddy 中导入腾讯地图官方 Skill 技能包6 新手避坑指南导入 Skill 常见问题解决7 本章小结前 言这是一篇面向新手的「CodeBuddy 通用开发环境搭建教程」全程零门槛不用配置复杂的本地开发环境跟着步骤走就能完成云端 IDE 的安装、登录以及腾讯位置服务开发所需的技能包导入为后续任何 LBS 相关项目开发打好基础。1 为什么推荐新手用 CodeBuddy 做腾讯 LBS 开发在正式开始安装前先简单说说为什么选择 CodeBuddy零本地环境配置自带云端开发环境不用安装复杂的编译器、依赖库打开就能写代码AI 辅助开发内置 AI 助手能帮你写代码、改 bug、解释腾讯地图 API 文档新手友好度拉满官方 Skill 支持可直接集成腾讯位置服务的官方 Skill 技能包不用自己找 SDK、配置鉴权一键导入就能用多端适配支持 Windows、Mac 系统还有网页版和客户端随时随地都能开发2 CodeBuddy IDE 下载与安装Windows 系统全流程下面开始手把手带你完成 CodeBuddy 的安装全程 9 个步骤每一步都有截图对应跟着操作就行。步骤 1进入官网下载 CodeBuddy IDE首先打开 CodeBuddy 官方网站点击页面右上角的「下载」按钮在下拉菜单中选择「CodeBuddy IDE」进入下载页面。步骤 2双击安装包启动安装向导下载完成后找到安装包文件格式为.exe文件名类似CodeBuddy-win32-x64-user-xxx.exe双击运行启动安装向导。步骤 3同意许可协议继续安装进入安装向导后首先会显示许可协议勾选「我同意此协议 (A)」然后点击「下一步 (N)」按钮继续安装流程。 说明这里的协议包含 CodeBuddy 的服务条款和隐私政策建议快速浏览确认无问题后再勾选同意。步骤 4自定义安装路径新手必看接下来是安装路径设置界面默认路径通常在 C 盘这里建议修改到 D 盘或其他非系统盘避免后续 C 盘空间不足影响软件运行。可以直接修改路径文本框也可以点击「浏览 (R)...」按钮选择自定义的安装文件夹确认路径后点击「下一步 (N)」❌ 避坑提示不要安装在中文路径下比如D:\编程工具\CodeBuddy部分软件对中文路径支持不佳可能导致后续功能异常建议用纯英文路径比如D:\Tools\CodeBuddy CN。步骤 5设置开始菜单文件夹这一步是设置程序快捷方式在开始菜单中的显示名称保持默认的「CodeBuddy CN」即可也可以自定义修改然后点击「下一步 (N)」。 小技巧如果不想在开始菜单创建快捷方式可以勾选左下角的「不创建开始菜单文件夹 (D)」后续直接用桌面快捷方式打开即可。步骤 6配置附加任务选项接下来是附加任务设置界面这里的选项建议按默认勾选新手不用额外修改「将 CodeBuddy CN 注册为受支持的文件类型的编辑器」关联代码文件双击就能用 CodeBuddy 打开「添加 buddy 命令到 PATH重启后生效」后续可以在 CMD 中直接调用 buddy 命令开发更方便确认选项后点击「下一步 (N)」。 补充如果需要桌面快捷方式可以勾选「创建桌面快捷方式 (D)」后续打开软件更方便。步骤 7确认安装配置准备安装进入「准备安装」界面这里会显示你之前设置的所有配置信息包括安装路径、开始菜单文件夹、附加任务等确认无误后点击「安装 (I)」按钮开始安装。⚠️ 检查点这里一定要核对安装路径避免误装到 C 盘如果需要修改点击「上一步 (B)」返回修改即可。步骤 8等待安装进度完成安装程序会自动解压文件并安装 CodeBuddy界面会显示安装进度条耐心等待即可一般 1-2 分钟就能完成。 注意安装过程中不要关闭窗口或断网避免安装包损坏导致软件无法正常启动。步骤 9安装完成启动 CodeBuddy安装完成后会显示「CodeBuddy CN 安装完成」界面默认勾选「运行 CodeBuddy CN」点击「完成 (F)」按钮即可直接启动软件开始使用 恭喜到这里CodeBuddy 的安装流程就全部完成了接下来我们就可以进入软件进行账号登录和后续的腾讯 LBS 开发配置啦。3 CodeBuddy 初始化与账号登录安装完成后我们将进入软件的初始化引导流程设置界面风格、完成账号登录为后续开发做好准备。步骤 1启动软件进入欢迎界面首次启动 CodeBuddy会进入欢迎界面点击「开始使用」按钮进入初始化引导流程。步骤 2选择界面风格与语言接下来可以选择你喜欢的界面风格推荐选择「深色」模式长时间写代码更护眼语言默认是「中文简体」确认后点击「继续」。 提示界面风格后续也可以通过设置菜单修改不用担心选错。步骤 3跳过配置导入如果之前没有使用过 VS Code、Cursor 等编辑器可以直接点击「跳过」按钮无需导入配置直接使用默认设置即可。步骤 4进入登录引导界面完成初始化引导后会显示「一切准备就绪」界面点击「登录」按钮进入账号登录流程。步骤 5扫码登录 CodeBuddy 账号登录界面支持微信扫码登录勾选「我已阅读并同意《服务条款》和《隐私协议》」然后用微信扫描二维码即可登录。步骤 6登录成功进入主界面扫码登录成功后会显示「登录成功」提示返回 IDE 继续使用即可进入 CodeBuddy 的主界面。步骤 7CodeBuddy 主界面预览登录后我们就能看到 CodeBuddy 的主界面了左侧是文件管理、插件市场等功能菜单中间是欢迎页支持「新建文件夹」、「打开文件夹」、「克隆 Git 仓库」三种方式创建项目界面布局和 VS Code 非常相似上手零门槛。4 腾讯位置服务官方 Skill 资源包获取为了让 CodeBuddy 能直接支持腾讯地图开发我们需要先下载腾讯位置服务提供的官方 Skill 技能包这些技能包包含了地图初始化、POI 搜索、路线规划等常用接口的封装导入后 AI 就能自动调用相关能力。步骤 1进入腾讯位置服务 Skill 下载页面打开腾讯位置服务官网进入「开发文档」→「Agent Skills」→「地图技能」→「基础能力 Skill」页面这里提供了三个核心技能包的下载地址TencentMap_jsapi_skills前端地图开发技能支持地图初始化、3D 视图控制、覆盖物绘制等TencentMap_lbs_skillsLBS 综合服务技能支持周边搜索、旅游规划、轨迹可视化等TencentMap_webservice_skillsWebserviceAPI 服务技能支持地址转换、POI 搜索、路线规划等点击右侧的下载链接把三个技能包全部下载到本地。步骤 2保存下载的 Skill 压缩包下载完成后你会得到三个.zip格式的压缩包建议统一保存到一个文件夹中比如D:\TencentMap_skills方便后续导入。步骤 3解压 Skill 压缩包将三个压缩包全部解压解压后的文件夹就是后续需要导入 CodeBuddy 的 Skill 文件建议解压到D:\codebuddy\skills目录下方便管理。5 在 CodeBuddy 中导入腾讯地图官方 Skill 技能包拿到解压后的腾讯地图 Skill 文件后我们就可以把它们导入到 CodeBuddy 中让 AI 助手获得腾讯地图开发的专属能力后续就能直接用自然语言生成地图项目代码了。步骤 0确认需要导入的 Skill 文件夹解压后的三个 Skill 包每个包的核心文件夹结构如下我们后续导入的就是这些文件夹TencentMap_jsapi_skills-main→tencentmap-jsapi-gl-skill前端地图渲染核心技能TencentMap_lbs_skills-main→tencentmap-lbs-skillLBS 位置服务技能TencentMap_webservice_skills-main→ 外层文件夹注意这个导入方式特殊后面会说明步骤 1打开 CodeBuddy 设置面板启动 CodeBuddy 后点击界面右上角的「设置」图标打开设置面板。步骤 2进入「技能」管理界面在设置面板中切换到「技能」标签页然后选择「用户 Skill」标签点击右上角的「导入 Skill」按钮开始导入技能包。步骤 3导入第一个核心 Skilltencentmap-jsapi-gl-skill在弹出的文件选择窗口中找到解压后的tencentmap-jsapi-gl-skill文件夹选中后点击「选择 Skill 文件夹」按钮完成导入。导入成功后你会在「用户 Skill」列表中看到这个技能包开关默认是开启状态。步骤 4导入第二个核心 Skilltencentmap-lbs-skill用同样的方法导入tencentmap-lbs-skill文件夹再次点击「导入 Skill」按钮找到解压后的tencentmap-lbs-skill文件夹点击「选择 Skill 文件夹」导入成功后界面左下角会弹出「Skill 文件夹 tencentmap-lbs-skill 导入成功」的提示。步骤 5导入第三个核心 Skilltencent-lbs-webservice这个技能包的导入方式和前两个不同需要直接选中解压后的外层文件夹TencentMap_webservice_skills-main而不是子文件夹点击「导入 Skill」按钮找到解压后的TencentMap_webservice_skills-main文件夹直接选中它点击「选择 Skill 文件夹」导入成功后列表中会显示tencent-lbs-webservice技能包。步骤 6确认所有 Skill 导入成功三个技能包都导入完成后在「用户 Skill」列表中可以看到三个技能包全部处于开启状态开关为紫色说明导入成功。步骤 7进入工作模式准备开发导入完成后返回 CodeBuddy 主界面点击「开始工作」按钮进入开发模式至此我们的腾讯地图开发环境就全部搭建完成了6 新手避坑指南导入 Skill 常见问题解决这里整理了几个新手导入 Skill 时的高频问题帮你一次性排雷导入失败提示 “无效的 Skill 文件夹”❌ 错误原因直接导入了.zip压缩包或者选错了文件夹路径✅ 解决方法先解压压缩包导入解压后的 Skill 文件夹确认文件夹内包含skill.json等配置文件导入成功后AI 无法调用腾讯地图能力❌ 错误原因技能包的开关没有开启或者导入路径包含中文✅ 解决方法确认列表中三个技能包的开关都是开启状态同时避免使用中文路径存放 Skill 文件tencent-lbs-webservice导入失败❌ 错误原因和前两个一样导入了子文件夹✅ 解决方法必须直接选中外层的TencentMap_webservice_skills-main文件夹导入不能进入子文件夹选择7 本章小结到这里我们的CodeBuddy 腾讯 LBS 开发环境搭建篇就全部完成了✅ 成功下载并安装了 CodeBuddy IDE✅ 完成了软件初始化、账号登录和界面设置✅ 下载并解压了腾讯位置服务官方的三个核心 Skill 包✅ 成功将所有 Skill 导入到 CodeBuddy 中开启了 AI 地图开发能力现在你已经拥有了零配置的腾讯地图开发环境接下来就可以直接用自然语言让 AI 帮你生成地图项目代码了