huwei HiDevLab webide 使用教程 指南

https://hidevlab.huawei.com/support/userGuide?currentKey=ide

什么是HiDevLab
注册/登录华为账号
在线开发
体验NoteBook操作指导手册
体验IDE操作指导手册
注销账号
简介

1. 环境使用
   1.1 申请在线开发环境权限
   1.2 创建环境
   1.2.1 创建镜像环境
   1.2.2 卡时申请
   1.3 WebIDE使用
   1.3.1 连接到WebIDE
   1.3.2 环境关机-WebIDE
   1.3.3 环境删除-WebIDE
   1.4 VS Code使用
   1.4.1 Visual Studio Code安装
   1.4.2 连接到Visual Studio Code
   1.4.3 环境关机-Visual Studio Code
   1.4.4 环境删除-Visual Studio Code
   1.4.5 从本地IDE创建环境
   1.5 AI IDE使用
   1.5.1 Trae
   1.5.1.1 Trae安装与启动
   1.5.1.2 连接到Trae
   1.5.1.3 环境关机-Trae
   1.5.1.4 环境删除-Trae
   1.5.1.5 从本地IDE创建环境
   1.5.2 通义灵码
   1.5.2.1 通义灵码安装与启动
   1.5.2.2 连接到通义灵码
   1.5.2.3 环境关机-通义灵码
   1.5.2.4 环境删除-通义灵码
   1.5.2.5 从本地IDE创建环境
   1.5.3 CodeBuddy
   1.5.3.1 CodeBuddy安装与启动
   1.5.3.2 连接到CodeBuddy
   1.5.3.3 环境关机-CodeBuddy
   1.5.3.4 环境删除-CodeBuddy
   1.5.3.5 从本地IDE创建环境
   1.6 SSH直连
   1.6.1 命令行连接
   1.6.2 图形工具连接
   1.6.2.1 MobaXterm 连接
   1.6.2.2 Xshell 连接
   1.6.3 SSH直连主机密钥验证失败（Host key verification failed）
2. 快速开始
3. Git操作指南
   3.1 GitHub代码拉取和提交
   3.1.1 方式一：Git 插件
   3.1.1.1 使用【Clone from Github】拉取与推送
   3.1.1.2 使用仓库url拉取与推送
   3.1.2 方式二：纯命令行
   3.2 GitCode代码拉取和提交
   3.2.1 方式一：Git 插件
   3.2.2 方式二：纯命令行
   3.3 其他问题
   3.3.1 设备码可以在哪里找到？
   3.3.2 如何检查推送前是否已关联远程仓库？
   3.3.3 用户名与个人令牌如何获取？
   简介
   欢迎使用HiDevLab - 在线开发 - 体验IDE！
   体验IDE 提供了高性能的在线开发环境，支持 WebIDE/本地IDE 一键接入，适用于生产级代码编写、高性能编译及工程项目开发等场景。本操作指导手册将帮助您了解如何使用体验IDE。

温馨提示：使用本地IDE连接环境时所用到的 openLiBing ResourceManage 插件已支持 Windows 系统与 macOS 系统。为保证您的使用，插件请升级到最新版本。

1. 环境使用
   1.1 申请在线开发环境权限
   打开HiDevLab-在线开发页面，点击【体验WebIDE】
   image
   点击【创建环境】，弹出弹窗，点击【申请权限】
   image
   选择需要申请的资源权限（可多选），点击【下一步：申请原因】
   image
   弹出【申请原因】弹窗，请选择您的身份角色，并完成对应内容填写，点击【提交】
   image
   提交成功后，可前往【个人中心 > 权限管理】查看权限审核状态
   image
   image

1.2 创建环境
1.2.1 创建镜像环境
在线开发环境权限审核通过后，打开【体验IDE】页面，点击【创建环境】后，在当前页面弹出环境配置窗口。
用户最多可以创建4个在线开发环境，请您根据需要，点击【+】创建多个环境。
每个环境需要用户手动选择所需的【算力类型】、【推荐镜像 or 自定义镜像】、【配置规格】等信息。
image
image
所有镜像信息填写完毕后，点击【确认】按钮，即可创建对应配置的在线开发环境，请耐心等待环境开机完成。
请注意，若您是创建的自定义镜像环境，预计开机需要10-30分钟，请耐心等待…
image
开机成功后，环境状态为【运行中】，后续可通过【连接】操作，进入环境。
image

描述： 内容为您创建环境时选择的算力平台、配置规格、镜像的信息。
挂载目录： 当前支持数据盘挂载目录下数据的持久化保存，请确保需要保存的数据放置于挂载目录下。
卡时： 右上角为您的剩余卡时数。卡时数与您所选的环境规格相关，选择1NPU规格使用1h约消耗1卡时，选择2NPU规格使用1h约消耗2卡时，选择4NPU规格使用1h约消耗4卡时。
此外，当您的环境状态为【已关机】时，可以点击【开机】按钮并在弹出框中点击【确定】进行开机，您也可以通过【批量开机】进行操作。
image
image

1.2.2 卡时申请
将鼠标悬浮到【用户名】位置，点击【卡时管理】，查看您的卡时概况，如果需要增加卡时，请点击【申请卡时】。
image

请您根据需要选择卡时，并按照模板提示填写申请原因。
image

1.3 WebIDE使用
1.3.1 连接到WebIDE
温馨提示：macOS 系统建议使用 Chrome 浏览器体验WebIDE。

环境开机完成后，开发环境状态为【运行中】，依次点击【连接】->【WebIDE】
image

点击后将自动打开WebIDE页面，WebIDE加载需要时间，请耐心等待，加载完成后页面如下

image

右上角体验时间代表【当前剩余可用时间】
右侧【操作指南】中 快速开始 供您参考
现在，可以开始您的开发之旅！

1.3.2 环境关机-WebIDE
进入【HiDevLab-在线开发-体验IDE】页面，请确认当前环境的操作中【关机】字体为蓝色，点击【关机】按钮并在弹出框中点击【确定】，您也可以通过【批量关机】进行操作。
image
image
环境状态变为【关机中】。
image
关机完成后，环境状态变为【已关机】（关机后则停止【当前剩余可用时间】计时，并保存您的用户数据）。
image
您后续可以选择【开机】或【删除】当前环境。

1.3.3 环境删除-WebIDE
请确认当前环境的操作中【删除】字体为蓝色，点击【删除】按钮并在弹出框中点击【确定删除】，则将删除当前环境，您也可以通过【批量删除】进行操作。
image
image
环境已删除
image

1.4 VS Code使用
1.4.1 Visual Studio Code安装
您可以点击 前往下载 进入VSCode 官方下载页面，根据您的本地环境下载对应的VSCode安装包并根据安装指引安装
image

安装完成后请打开VSCode
image

1.4.2 连接到Visual Studio Code
温馨提示：为保证您的使用，openLiBing ResourceManage 插件请升级到最新版本。

打开【HiDevLab-在线开发-体验IDE】页面，点击已创建的环境的【连接】->【Visual Studio Code】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开Visual Studio Code】
image

点击后将会自动跳转至Visual Studio Code页面，弹出窗口，点击【安装扩展和 打开 URI(I)】和【启用扩展和 打开 URI(E)】来安装openLiBing插件并打开环境连接URI
image

image

页面右下角会依次显示当前连接进度

登录成功通过
环境成功挂载
环境就绪并成功连接
image

此时会弹出新的【Visual Studio Code窗口】，点击右下角提示中的【安装并重新加载】来自动安装Remote - SSH插件
image

插件安装完毕后，窗口会重新打开，上方命令输入框显示【Selete the platform of the remote host “xxx”】，点击后选择【Linux】即可
image

等待10S左右，Visual Studio Code配置完成后，会显示如下窗口，表示您已使用本地Visual Studio Code链接到HiDevLab在线环境
image

接下来请开始您的开发之旅。

温馨提示：涉及Git使用，您可以参考本文档中【3. Git操作指南】来使用Git

1.4.3 环境关机-Visual Studio Code
环境关机也可以参考1.3.2小节，下面介绍如何在本地操作

回到 Visual Studio Code 本地窗口，点击【openLiBing ResourceManage】，可以看到当前正在运行中的环境，点击【关机】
image

右下角会弹出弹窗，点击【确定】
image
右下角会显示关机进度（关机后则停止【当前剩余可用时间】计时，并保存您的用户数据）
image
image
您后续可以选择【开机】或【删除】当前环境

1.4.4 环境删除-Visual Studio Code
环境删除也可以参考1.3.3小节，下面介绍如何在本地删除环境

环境关机后，点击【删除】
image
右下角会弹出弹窗，点击【确定】
image
右下角会显示删除进度
image
已删除当前环境
image

1.4.5 从本地IDE创建环境
若 Visual Studio Code 尚未安装【openLiBing ResourceManage】插件，请先在扩展商店安装最新版本插件。
image
安装好最新版【openLiBing ResourceManage】插件后，点击【登录】，弹出框点击【打开】
image

跳转到浏览器，登录您的HiDevLab账号后，弹出弹窗，点击【确定】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开Visual Studio Code】
image

点击后，打开 Visual Studio Code 页面，点击【打开】，提示登录成功
image
image

点击【申请环境】，若无权限，请前往HiDevLab页面申请权限，请参考【1.1 申请在线开发环境权限】
权限申请通过后，点击【申请环境】，请手动选择所需的【推荐镜像】or【自定义镜像】、【配置规格】以及【选择存储大小】
image
image

1.5 AI IDE使用
温馨提示：目前，本手册及对应服务流程均基于国内版设计，暂不支持国际版。使用国际版可能会导致部分功能无法正常使用或与文档说明不一致。

1.5.1 Trae
Trae（https://www.trae.cn/）是一款融合AI能力的开发工具，集成智能代码补全、生成、解释、修复等功能，支持主流编程语言。提供IDE和SOLO双重开发模式，内置SOLO Coder智能体，覆盖从编码、调试、测试到重构、部署的全开发场景，能有效保障代码稳健性，提高开发效率与质量。

温馨提示：当前仅支持 Trae cn（国内版），建议您下载对应版本应用，以畅享完整服务体验。

1.5.1.1 Trae安装与启动
您可以点击 前往下载 进入Trae 官方下载页面，根据您的本地环境下载对应的 Trae IDE 安装包并根据安装指引安装
image
安装完成后，启动 Trae， 然后跟随界面指引完成初始设置，包括：

选择主题和语言。
从 VS Code 或 Cursor 导入已有配置。
添加 Trae 相关的命令行。
使用您的账号登录 Trae。
进入 Trae 后，点击左侧面板中央的【打开文件夹】按钮，或在界面左上角点击【选择项目->打开文件夹】，从本地选择一个文件夹并在 Trae 中将其打开。
您也可以使用【克隆 Git 仓库】，git使用请参考【3. Git操作指南】。
image

Trae 提供双重开发模式。在界面左上角，可以根据任务需求自由切换模式。
IDE 模式：保留传统的开发方式，开发者可全程自主控制流程，获得更强的掌控感。
image

SOLO 模式：以 AI 为主导，自动规划任务并完成从需求理解、代码生成、测试，到成果预览的全流程。
image

更多Trae使用指南可阅读官方文档：https://docs.trae.cn/ide/what-is-trae

1.5.1.2 连接到Trae
温馨提示：为保证您的使用，openLiBing ResourceManage 插件请升级到最新版本。

打开【HiDevLab-在线开发-体验IDE】页面，点击已创建的环境的【连接】->【AI IDE】->【Trae】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后将会自动跳转至 Trae 页面，弹出窗口，点击【安装扩展和 打开 URI(I)】来安装openLiBing插件并打开环境连接URI
image
页面右下角会依次显示当前连接进度

登录成功通过
环境成功挂载
环境就绪并成功连接
image
此时会弹出新的【Trae 窗口】，等待10S左右，配置完成后，窗口上方可以看到当前环境目录，表示您已使用本地 Trae 连接到HiDevLab在线环境
image

接下来请开始您的开发之旅。

温馨提示：涉及Git使用，您可以参考本文档中【3. Git操作指南】来使用Git

1.5.1.3 环境关机-Trae
环境关机也可以参考1.3.2小节，下面介绍如何在本地操作
回到 Trae 本地窗口，点击【openLiBing ResourceManage】，可以看到当前正在运行中的环境，点击【关机】
image
右下角会弹出弹窗，点击【确定】
image
右下角会显示关机进度（关机后则停止【当前剩余可用时间】计时，并保存您的用户数据）
image
image
您后续可以选择【开机】或【删除】当前环境

1.5.1.4 环境删除-Trae
环境删除也可以参考1.3.3小节，下面介绍如何在本地删除环境

环境关机后，点击【删除】
image
右下角会弹出弹窗，点击【确定】
image
右下角会显示删除进度
image
已删除当前环境
image

1.5.1.5 从本地IDE创建环境
若 Trae 尚未安装【openLiBing ResourceManage】插件，请先在扩展商店安装最新版本插件。
image

安装好最新版【openLiBing ResourceManage】插件后，点击【登录】，弹出框点击【打开】
image

跳转到浏览器，登录您的HiDevLab账号后，弹出弹窗，点击【确定】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后，打开 Trae 页面，点击【打开】，提示登录成功
image

image

点击【申请环境】，若无权限，请前往HiDevLab页面申请权限，请参考【1.1 申请在线开发环境权限】
权限申请通过后，点击【申请环境】，请手动选择所需的【推荐镜像】or【自定义镜像】、【配置规格】以及【选择存储大小】
image
image

1.5.2 通义灵码
通义灵码（https://lingma.aliyun.com/）是一款智能编码辅助工具，提供代码智能生成、智能问答、多文件修改、编程智能体等能力，可以为开发者带来高效、流畅的编码体验。

1.5.2.1 通义灵码安装与启动
您可以点击 前往下载 进入通义灵码官方下载页面，根据您的本地环境下载对应的通义灵码安装包并根据安装指引安装
image
安装完成后，启动通义灵码， 然后跟随界面指引完成初始设置，包括：

选择主题和语言。
从 VS Code 或 Cursor 导入已有配置。
使用您的账号登录通义灵码。
进入通义灵码后，在菜单中选择【文件->打开文件夹】，或在界面中点击【打开项目】，打开您所使用的文件夹。
您也可以使用【克隆仓库】，git使用请参考【3. Git操作指南】。

image
通义灵码提供两种工作模式：
Editor 模式：实时协作编程，一问一答
image

Quest 模式：任务委派，自主执行，放手交付
image

更多通义灵码使用指南可阅读官方文档：https://help.aliyun.com/zh/lingma/product-overview/introduction-of-lingma

1.5.2.2 连接到通义灵码
温馨提示：为保证您的使用，openLiBing ResourceManage 插件请升级到最新版本。

打开【HiDevLab-在线开发-体验IDE】页面，点击已创建的环境的【连接】->【AI IDE】->【通义灵码】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后将会自动跳转至通义灵码页面，弹出窗口，点击【安装扩展和 打开 URI(I)】来安装openLiBing插件并打开环境连接URI
image

页面左下角会依次显示当前连接进度

登录成功通过
环境成功挂载
环境就绪并成功连接
image

此时会弹出新的【通义灵码窗口】，左上角可以看到当前环境目录，表示您已使用本地 通义灵码 连接到HiDevLab在线环境
image

接下来请开始您的开发之旅。

温馨提示：涉及Git使用，您可以参考本文档中【3. Git操作指南】来使用Git

1.5.2.3 环境关机-通义灵码
环境关机也可以参考1.3.2小节，下面介绍如何在本地操作
回到 通义灵码 本地窗口，点击【openLiBing ResourceManage】，可以看到当前正在运行中的环境，点击【关机】
image
左下角会弹出弹窗，点击【确定】
image
左下角会显示关机进度（关机后则停止【当前剩余可用时间】计时，并保存您的用户数据）
image
image

您后续可以选择【开机】或【删除】当前环境

1.5.2.4 环境删除-通义灵码
环境删除也可以参考1.3.3小节，下面介绍如何在本地删除环境

环境关机后，点击【删除】
image
左下角会弹出弹窗，点击【确定】
image
左下角会显示删除进度
image
已删除当前环境
image

1.5.2.5 从本地IDE创建环境
若 通义灵码 尚未安装【openLiBing ResourceManage】插件，请先在扩展商店安装最新版本插件。
image

安装好最新版【openLiBing ResourceManage】插件后，点击【登录】，弹出框点击【打开】
image
跳转到浏览器，登录您的HiDevLab账号后，弹出弹窗，点击【确定】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后，打开 通义灵码 页面，点击【打开】，提示登录成功
image

image

点击【申请环境】，若无权限，请前往HiDevLab页面申请权限，请参考【1.1 申请在线开发环境权限】
权限申请通过后，点击【申请环境】，请手动选择所需的【推荐镜像】or【自定义镜像】、【配置规格】以及【选择存储大小】
image
image

1.5.3 CodeBuddy
CodeBuddy（https://www.codebuddy.cn/home/）是一款基于 AI 的全流程智能编程工具，融合了设计、编码、调试与部署全流程，致力于构建产品、设计、研发、部署无缝协作的共生环境。

1.5.3.1 CodeBuddy安装与启动
您可以点击 前往下载 进入 CodeBuddy 官方下载页面，根据您的本地环境下载对应的 CodeBuddy 安装包并根据安装指引安装
image
安装完成后，启动 CodeBuddy， 然后跟随界面指引完成初始设置，包括：

选择主题和语言。
从 VS Code 或 Cursor 导入已有配置。
使用您的账号登录 CodeBuddy。
进入 CodeBuddy 后，点击左侧面板中央的【打开文件夹】按钮，或在界面左上角点击【文件->打开文件夹】，从本地选择一个文件夹并在 CodeBuddy 中将其打开。
您也可以使用【克隆 Git 仓库】，git使用请参考【3. Git操作指南】。
image

CodeBuddy提供了编程模式和智能体模式，编程模式基本功能如下图所示。
image

点击【开始工作】或【打开Agents】会自动打开新的窗口，进入智能体模式，您可以直接创建任务、持续对话、查看执行结果，并在同一个界面中完成文件检查、代码审查和结果预览。
image

更多 CodeBuddy 使用指南可阅读官方文档：https://www.codebuddy.cn/docs/ide/Introduction

1.5.3.2 连接到CodeBuddy
温馨提示：为保证您的使用，openLiBing ResourceManage 插件请升级到最新版本。

打开【HiDevLab-在线开发-体验IDE】页面，点击已创建的环境的【连接】->【AI IDE】->【CodeBuddy】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后将会自动跳转至 CodeBuddy 页面，弹出窗口，点击【安装扩展和 打开 URI(I)】来安装openLiBing插件并打开环境连接URI
image

页面左下角会依次显示当前连接进度

登录成功通过
环境成功挂载
环境就绪并成功连接
image

此时会弹出新的【CodeBuddy 窗口】，等待10S左右，配置完成后，左上方可以看到当前环境目录，表示您已使用本地 CodeBuddy 连接到HiDevLab在线环境

image

接下来请开始您的开发之旅。

温馨提示：涉及Git使用，您可以参考本文档中【3. Git操作指南】来使用Git

1.5.3.3 环境关机-CodeBuddy
环境关机也可以参考1.3.2小节，下面介绍如何在本地操作

回到 CodeBuddy 本地窗口，点击【openLiBing ResourceManage】，可以看到当前正在运行中的环境，点击【关机】
image
左下角会弹出弹窗，点击【确定】
image
左下角会显示关机进度（关机后则停止【当前剩余可用时间】计时，并保存您的用户数据）
image
image

您后续可以选择【开机】或【删除】当前环境

1.5.3.4 环境删除-CodeBuddy
环境删除也可以参考1.3.3小节，下面介绍如何在本地删除环境

环境关机后，点击【删除】
image
左下角会弹出弹窗，点击【确定】
image
左下角会显示删除进度
image
已删除当前环境
image

1.5.3.5 从本地IDE创建环境
若 CodeBuddy 尚未安装【openLiBing ResourceManage】插件，请先在扩展商店安装最新版本插件。
image

安装好最新版【openLiBing ResourceManage】插件后，点击【登录】，弹出框点击【打开】
image

跳转到浏览器，登录您的HiDevLab账号后，弹出弹窗，点击【确定】
image

弹出页面请选择【始终允许hidevlab.huawei.com在关联的应用中打开此类链接】并点击【打开】
image

点击后，打开 CodeBuddy 页面，点击【打开】，提示登录成功
image

image

点击【申请环境】，若无权限，请前往HiDevLab页面申请权限，请参考【1.1 申请在线开发环境权限】
权限申请通过后，点击【申请环境】，请手动选择所需的【推荐镜像】or【自定义镜像】、【配置规格】以及【选择存储大小】
image
image

1.6 SSH直连
开发环境状态为【运行中】后，依次点击【连接】->【SSH直连】，弹出弹窗
image
image

1.6.1 命令行连接
当您使用命令行，通过 Windows cmd / PowerShell、macOS / Linux Terminal 等进行SSH直连时，操作步骤如下：

打开终端：Windows 打开 cmd 或 PowerShell，macOS / Linux 打开 Terminal。
点击命令框右上角的“复制”按钮，将环境连接命令粘贴至终端后按回车执行。
首次连接若提示 Are you sure you want to continue connecting?，输入 yes 并按回车。
出现 password: 提示时，点击密码行眼睛图标展开明文，再点击“复制”获取密码并粘贴。输入时屏幕无回显属正常现象，粘贴后按回车。
终端提示符变为 root@主机名:~# 即表示连接成功。
操作示意图如下：
image
首次连接若提示 Are you sure you want to continue connecting?，输入 yes 并按回车。
image

SSH直连的环境关机与删除，请参考【1.3.2 环境关机-WebIDE】和【1.3.3 环境删除-WebIDE】

1.6.2 图形工具连接
1.6.2.1 MobaXterm 连接
当您使用图形工具，通过 MobaXterm 进行SSH直连时，操作步骤如下：

打开本地终端：MobaXterm 在 Home 页面点击 Start local terminal，其他图形化工具类似。
点击命令框右上角的“复制”按钮，将环境连接命令粘贴至本地终端后按回车执行。
首次连接若提示 Are you sure you want to continue connecting?，输入 yes 并按回车。
出现 password: 提示时，点击密码行眼睛图标展开明文，再点击“复制”获取密码并粘贴。输入时屏幕无回显属正常现象，粘贴后按回车。
终端提示符变为 root@主机名:~# 即表示连接成功。
MobaXterm 连接操作如下：
image
image
SSH直连的环境关机与删除，请参考【1.3.2 环境关机-WebIDE】和【1.3.3 环境删除-WebIDE】

1.6.2.2 Xshell 连接
当您使用图形工具，通过 Xshell 进行SSH直连时，操作步骤如下：
Xshell 依次点击“文件 → 新建”
image
以下面的SSH直连命令为例：

ssh -J jt_F655XXXXXXXXXXXXXXXXXXXX:0F4C5XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXC0XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX4FCBE@<跳板机IP>:<端口> root@<目标IP>
【协议】选择SSH，【主机】输入目标IP

image
点击【代理】，【代理服务器】选择jumper，点击【浏览】
image

选中jumper记录，点击【编辑】
image
分别输入跳板机IP、端口、与用户名（SSH直连命令中，jt_开头至@之前的内容），点击【确定】
image
回到下图页面，点击【关闭】

image
点击【连接】

image
输入用户名root，点击【确定】
image
输入密码，点击【确定】

image
成功连接环境

image

SSH直连的环境关机与删除，请参考【1.3.2 环境关机-WebIDE】和【1.3.3 环境删除-WebIDE】

1.6.3 SSH直连主机密钥验证失败（Host key verification failed）
若您在使用SSH直连过程中，遇到报错 Host key verification failed （如下图），请先执行 ssh-keygen -R <环境连接命令中的IP> 命令，然后重新粘贴环境连接命令，按回车执行。
以下图为例，请先执行 ssh-keygen -R 174.14.51.9 ，然后重新执行环境连接命令。
image

2. 快速开始
   体验IDE的【推荐镜像】中，部分镜像（例如，​vLLM-Ascend、​SGLang、​Triton-Ascend​、PyTorch-NPU）准备了快速开始指南，帮助您快速搭建并启动模型推理或训练任务，您可以在连接镜像环境之后看到。
   如下图所示。

image

3. Git操作指南
   本节将介绍 HiDevLab-在线开发-体验IDE 模式下如何进行GitHub和GitCode代码拉取和提交。由于WebIDE与本地IDE上使用方式基本一致，本节以WebIDE为例介绍详细操作。

GitHub代码拉取和提交建议参考 3.1.1.1 使用【Clone from Github】拉取与推送 小节。
GitCode代码拉取和提交建议参考 3.2.1 方式一：Git 插件 小节。
3.1 GitHub代码拉取和提交
WebIDE与本地IDE上git插件使用方式一致，需注意，在拉取GitHub上的代码仓时由于网络原因，可能会有网络超时现象，重试即可。

3.1.1 方式一：Git 插件
3.1.1.1 使用【Clone from Github】拉取与推送
1、GitHub代码拉取

1、在Web IDE页面，按下F1，在上方窗口中输入git，点击git clone。

2、点击【Clone from GitHub】。
image
3、点击Allow。

4、复制设备码，点击 Copy & Continue to GitHub。

5、点击Open。

6、点击continue。

7、ctrl v 输入设备码，点击continue。

8、点击授权。

9、输入GitHub账号登录密码。
image
10、授权完成。

11、授权完成后，回到Web IDE，显示当前账号下的个人仓库，可拉取个人代码仓。
image
12、点击OK。
image
13、打开项目。
image
14、如下图，已拉取vllm-ascend_test项目。
image

2、推送代码至GitHub

1、推送代码前，首先打开终端。

依次执行下方命令（用户名和邮箱请修改为自己的GitHub用户名和邮箱），如果在同一环境下，该命令只需要执行一次。

git config --global user.name “your name”
git config --global user.email “your email”

2、更改代码仓文件内容后，保存文件（这里我们新增一个文件做测试），可以看到左侧出现了一个蓝色的图标，点击进入Git管理界面。

3、点击“+”，暂存更改的内容，即stage changes。在①处输入commit信息，点击Commit。

4、点击Sync Changes同步到远端代码仓。

5、点击OK。

6、开始推送。如果遇到推送超时未上传成功，请尝试重新上传或者刷新页面重新点击Sync Changes。

7、刷新GitHub代码仓，可以看到已提交成功。

3.1.1.2 使用仓库url拉取与推送
1、GitHub代码拉取

使用仓库url直接拉取代码仓时，不需要进行GitHub授权，在推送时才需要进行授权。

1、提前在GitHub复制代码仓HTTPS URL。

2、在Web IDE页面，按下F1，在上方窗口中输入git，点击git clone。

3、出现以下界面，输入刚才复制的 HTTPS URL，点击下图标注②的部分。

4、点击OK。
image
开始拉取代码仓，右下角会有进度条。

5、打开项目。
image
6、如下图，已拉取vllm-ascend_test项目。

2、推送代码至GitHub

使用仓库url直接拉取代码仓后，推送可按照3.1.1.1小节的操作步骤进行推送与授权。

3.1.2 方式二：纯命令行
纯命令行使用与git命令行操作一致，在terminal中执行即可。

1、GitHub代码拉取

打开终端，输入 git clone 命令，回车。

2、推送代码至GitHub

1、仓库下有内容更新后，打开终端。如果根目录下有多个代码仓的话，需要先切换到对应的代码仓目录下，切换命令为 cd <代码仓路径> ，具体见下图。
先在代码仓目录右击，点击 Copy Path。

然后运行命令 cd <代码仓路径> 。

2、依次执行下方命令（用户名和邮箱请修改为自己的GitHub用户名和邮箱），如果在同一环境下，该命令只需要执行一次。

git config --global user.name “your name”
git config --global user.email “your email”

3、依次输入git命令进行上传。

git add .
git commit -m “提交说明”
git push origin <分支名称>
输入 git add . 回车后，暂存更改；
输入 git commit -m “提交说明” ，将更改提交到本地。
4、输入git push origin <分支名称>，回车后，需要参考3.1.1.1进行授权，完成授权后，会推送成功。

5、刷新GitHub代码仓，可以看到已提交成功。

3.2 GitCode代码拉取和提交
3.2.1 方式一：Git 插件
1、GitCode代码拉取

1、提前在GitCode复制代码仓HTTPS URL。

2、在Web IDE页面，按下F1，在上方窗口中输入git，点击git clone。

3、出现以下界面，输入刚才复制的 HTTPS URL，点击下图标注②的部分。

4、点击OK。

开始拉取代码仓，右下角会有进度条。

5、打开项目。
image
6、点击Open后，如下图，已拉取triton-ascend-test项目。

2、推送代码至GitCode

1、首先要完成Git全局配置，在GitCode复制配置命令，如下图。

打开终端，依次执行下方命令（用户名和邮箱请修改为自己的GitCode用户名和邮箱），如果在同一环境下，该命令只需要执行一次。

git config --global user.name “your name”
git config --global user.email “your email”

2、更改代码仓文件内容后，保存文件（这里我们新增一个文件做测试），可以看到左侧出现了一个蓝色的图标，点击进入Git管理界面。

3、点击“+”，暂存更改的内容，即stage changes。在①处输入commit信息，点击Commit。

4、点击Sync Changes同步到远端代码仓。

5、点击OK。

6、输入Username和Password。Username是个人GitCode的用户名，Password是个人令牌，具体生成方式见3.3.3。

7、开始推送。如果遇到推送超时未上传成功，请尝试重新上传或者刷新页面重新点击Sync Changes。

8、刷新GitCode代码仓，可以看到已提交成功。

3.2.2 方式二：纯命令行
纯命令行使用与git命令行操作一致，在terminal中执行即可。

1、GitCode代码拉取

打开终端，输入 git clone 命令，回车。

2、推送代码至GitCode

1、仓库下有内容更新后，打开终端。如果根目录下有多个代码仓的话，需要先切换到对应的代码仓目录下，切换命令为 cd <代码仓路径> ，具体见下图。
先在代码仓目录右击，点击 Copy Path。

然后运行命令 cd <代码仓路径> 。
image
2、完成Git全局配置，在GitCode复制配置命令，如下图。

依次执行下方命令（用户名和邮箱请修改为自己的GitCode用户名和邮箱），如果在同一环境下，该命令只需要执行一次。

git config --global user.name “your name”
git config --global user.email “your email”

3、依次输入git命令进行上传。

git add .
git commit -m “提交说明”
git push origin <分支名称>
输入 git add . 回车后，暂存更改；
输入 git commit -m “提交说明” ，将更改提交到本地。
4、输入git push origin <分支名称>，回车后，输入Username和Password后，推送成功。其中，Username是个人GitCode的用户名，Password是个人令牌，具体生成方式见3.3.3。

5、刷新GitCode代码仓，可以看到已提交成功。

3.3 其他问题
3.3.1 设备码可以在哪里找到？
回到Web IDE，可在右下角找到设备码，并复制。
设备码是一个一次性验证码，用于登录或授权第三方应用访问你的GitHub账户。
image

3.3.2 如何检查推送前是否已关联远程仓库？
方法一：查看窗口的左下角，如果看到类似这样的信息：main ↑n 或 main ↓n。

​如果显示 main ↑n​：
这是一个​明确的已关联远程仓库成功的信号​！说明：
已经关联了远程仓库。
你的本地 main 分支有 n 个提交还没有推送到远程）。
​如果显示 main ↓n​：
同样说明​已经关联​，并且远程仓库有 n 个新提交你需要拉取。
结论：如果你看到 ↑ 或 ↓ 箭头，那么恭喜你，关联已经存在。如果只看到分支名，需要进一步确认。
方法二：使用终端命令。

打开终端。
输入 git remote -v 命令并按回车。
场景A：已正确关联
origin https://github.com/你的用户名/你的仓库名.git (fetch)
origin https://github.com/你的用户名/你的仓库名.git (push)
这表示你的本地仓库已经关联了一个名为 origin 的远程仓库，并列出了用于抓取（fetch）和推送（push）的 URL。

场景B：未关联任何远程仓库
如果运行命令后，终端没有任何输出，或者只换了一行空白的命令行，那就说明​还没有关联任何远程仓库​。
场景C：关联了错误的仓库
如果显示的 URL 不是你想要的仓库地址，说明关联有误。
3.3.3 用户名与个人令牌如何获取？
可以在GitCode代码页面点击【Clone】→点击【配置并使用个人访问令牌】，也可以直接鼠标悬浮到用户头像，点击【我的项目→访问令牌→新建访问令牌】。

如需更多帮助，请联系我们。

祝您使用愉快！