云课堂在银河麒麟桌面操作系统（教育版）中可通过麒麟软件商店一键安装、手动下载.deb包部署、启用教学空间集成服务及配置麒麟云账号四步解决未预装或无法启动问题。
如果您希望在银河麒麟桌面操作系统（教育版）中使用云课堂功能，但系统未预装或无法正常启动该工具，则可能是由于软件源未启用、依赖缺失或云课堂客户端版本不匹配所致。以下是解决此问题的步骤：
一、通过麒麟软件商店安装云课堂
麒麟软件商店是教育版系统默认集成的应用分发平台，已上架适配V10 SP1及后续版本的官方云课堂客户端，支持一键安装与自动更新。
1、点击屏幕左下角“开始菜单”，选择“软件商店”图标，进入应用市场界面。
2、在搜索框中输入云课堂，确认结果中显示发布者为“麒麟软件有限公司”或“教育部教育信息化推进办公室联合认证”。
3、点击对应应用卡片，查看版本号是否为v3.2.1及以上（2026年4月起教育版默认要求），点击“安装”按钮。
4、安装完成后，在“我的应用”或“教学工具”分类中查找“云课堂”图标，首次启动时将自动初始化教学空间配置。
二、手动下载安装包方式部署
当软件商店中未检索到云课堂，或需部署定制化版本（如区域教育局专用版）时，可从可信渠道获取离线安装包，适用于断网环境或批量部署场景。
1、访问https://edu.kylinos.cn/cloudclass，使用教育机构账号登录后下载对应架构安装包（x86_64 或 ARM64）。
2、将下载的.deb格式文件保存至本地，右键选择“使用软件安装器打开”。
3、若提示依赖错误，打开终端执行：sudo apt install -f，自动修复缺失依赖。
4、安装完毕后，在终端输入：cloudclass --version，验证客户端版本是否≥3.2.1。
三、启用麒麟教学空间集成模式
云课堂深度集成于“麒麟教学空间”框架内，仅当教学空间服务正常运行时，方可调用课件同步、学情数据回传等核心能力。
1、打开“控制中心”→“系统管理”→“服务管理”，确认kylin-teaching-space服务状态为“正在运行”。
2、若服务未启动，点击右侧“启动”按钮；若启动失败，执行：sudo systemctl restart kylin-teaching-space。
3、返回桌面，右键任务栏空白处，选择“添加小部件”，勾选“教学空间快捷入口”，拖入云课堂快捷方式。
4、重启云课堂应用，观察右上角是否显示已接入教学空间 v2.5标识。
四、配置云账号并同步教学资源
云课堂依赖麒麟云账户实现跨设备配置同步、课程资源下载及AI助教调用，未登录云账号将限制大部分在线功能。
1、启动云课堂后，点击登录界面右上角“云账号”图标，选择“扫码登录”或“手机号登录”。
2、使用已在https://cloud.kylinos.cn完成实名认证的教育账号登录（学校统一域名后缀如@school.edu.cn）。
3、登录成功后，系统自动拉取本学期课表、已购课程包及教师共享资源库，进度条达100%后提示“同步完成”。
4、在“我的空间”中长按任意课程卡片，选择“设为常用”，该课程将出现在麒麟教学空间首页快捷入口。
