若命令行无法识别dart命令，需确认系统架构、下载匹配sdk、解压至/opt/dart-sdk、配置dart_sdk与path环境变量，并在新终端中验证dart --version及运行hello.dart。
如果您在银河麒麟操作系统上尝试配置Dart SDK，但命令行无法识别dart命令，则可能是由于SDK未正确下载、解压路径不明确或环境变量未生效。以下是针对银河麒麟系统（基于Linux内核，通常为ARM64或AMD64架构，桌面版常用UKUI或Wayland环境）安装与配置Dart SDK的具体操作步骤：
一、确认系统架构与版本
银河麒麟OS存在多个分支（如V10 SP1/SP2/SP3、KOS 23.0等），需先确认当前系统架构及发行版代号，以选择匹配的Dart SDK二进制包。Dart官方归档页仅提供x64与ARM64格式的Linux SDK，不支持mips64el或loongarch64等国产CPU变种（若您的设备使用龙芯或申威处理器，请跳至方法三）。
1、打开终端，执行以下命令获取系统信息：
2、输入uname -m，查看输出结果：aarch64表示ARM64架构，x86_64表示AMD64/x64架构。
3、输入cat /etc/os-release | grep -E "(VERSION_ID|PRETTY_NAME)"，确认麒麟OS主版本号（如VERSION_ID="10"）及是否为SP3更新分支。
4、访问Dart SDK官方归档页（https://dart.dev/tools/sdk/archive），根据架构与版本选择对应压缩包，例如：dartsdk-linux-x64-release.zip（x86_64）或 dartsdk-linux-arm64-release.zip（aarch64）。
二、手动下载并解压SDK至标准路径
该方法适用于所有麒麟OS版本，不依赖第三方包管理器，可精确控制安装位置与权限，避免因snap或apt源滞后导致版本陈旧问题。
1、创建统一SDK根目录：sudo mkdir -p /opt/dart-sdk。
2、进入该目录：cd /opt/dart-sdk。
3、使用wget下载对应架构的SDK压缩包（以稳定版3.4.0 x64为例）：sudo wget -c https://storage.googleapis.com/dart-archive/channels/stable/release/3.4.0/sdk/dartsdk-linux-x64-release.zip。
4、解压并覆盖原内容：sudo unzip dartsdk-linux-x64-release.zip -d /opt/（解压后生成/opt/dart-sdk子目录）。
5、修正目录所有权（防止普通用户无权读取）：sudo chown -R $USER:$USER /opt/dart-sdk。
三、通过麒麟软件商店或apt安装（仅限适配源）
部分麒麟OS企业版或教育版已将Dart SDK纳入本地镜像源，可通过系统级包管理器安装，自动处理依赖与环境变量注册，适合对命令行操作不熟悉的用户。
1、更新软件源列表：sudo apt update。
2、检查是否存在dart相关包：apt list --installed | grep dart；若无结果，继续执行下一步。
3、尝试安装官方维护的dart包（适用于麒麟V10 SP3及以上）：sudo apt install dart。
4、若提示“无法定位软件包”，则启用麒麟OS社区源（需管理员权限）：sudo echo "deb https://archive.kylinos.cn/kylin/KYLIN-ALL/ v10 main" | sudo tee -a /etc/apt/sources.list，再执行sudo apt update && sudo apt install dart。
5、安装完成后，SDK默认位于/usr/lib/dart，其bin目录已由系统自动写入/etc/environment，无需手动配置PATH。
四、配置用户级环境变量
无论采用方法二或方法三，均需确保当前登录用户的Shell能识别dart命令。银河麒麟桌面版默认使用bash或zsh，需编辑对应配置文件。
1、判断当前Shell类型：echo $SHELL，输出/bin/bash或/bin/zsh。
2、若为bash，编辑~/.bashrc：nano ~/.bashrc；若为zsh，编辑~/.zshrc：nano ~/.zshrc。
3、在文件末尾添加以下两行（请将/opt/dart-sdk替换为实际解压路径）：
export DART_SDK=/opt/dart-sdk
export PATH=$PATH:$DART_SDK/bin
4、使配置立即生效：source ~/.bashrc 或 source ~/.zshrc。
5、验证变量是否加载：echo $PATH | grep dart，应返回包含/opt/dart-sdk/bin的字符串。
五、验证安装与基础运行
完成环境变量配置后，需在全新终端会话中测试Dart CLI是否可用，并确认其具备基本执行能力，排除缓存或会话残留干扰。
1、关闭当前终端，重新打开一个终端窗口（不可使用source重载替代）。
2、输入dart --version，应返回类似Dart SDK version: 3.4.0的输出。
3、创建测试文件：echo "void main() { print('Hello from Kylin OS!'); }" > hello.dart。
4、执行该脚本：dart hello.dart，终端应立即输出Hello from Kylin OS!。
5、若出现Permission denied错误，请检查/opt/dart-sdk/bin/dart是否具有可执行权限：ls -l /opt/dart-sdk/bin/dart，缺失x位则运行chmod +x /opt/dart-sdk/bin/dart。
