统信UOS安装配置Dart开发环境指南

要在统信UOS系统上运行Flutter开发或编写Dart命令行工具，首先必须安装Dart SDK并正确配置环境变量。否则，执行dart命令时会提示“command not found”，后续的构建、测试和调试任务均无法进行。

下载Dart SDK压缩包

打开终端，执行以下命令，下载官方最新稳定版Dart SDK（Linux x64）：

wget https://storage.googleapis.com/dart-archive/channels/stable/release/latest/sdk/dartsdk-linux-x64-release.zip

特别提醒：必须使用 https://storage.googleapis.com 官方直链。不要贪图方便使用镜像站或第三方源，否则可能下载到损坏的包或旧版本，解压后 dart 二进制文件可能缺失，权限也会异常。

解压并放置到系统路径

首先创建一个统一存放的目录：

mkdir -p ~/devtools/dart-sdk

然后将压缩包解压到该目录：

unzip dartsdk-linux-x64-release.zip -d ~/devtools/dart-sdk/

注意：切勿解压到 /tmp 或桌面等临时路径。这些位置可能被系统自动清理，或者因用户权限策略导致新终端会话中 dart 命令失效。

配置环境变量

编辑当前用户的 shell 配置文件，添加以下内容：

echo 'export DART_SDK=$HOME/devtools/dart-sdk/dart-sdk' >> ~/.bashrc
echo 'export PATH=$PATH:$DART_SDK/bin' >> ~/.bashrc

然后让配置立即生效：

source ~/.bashrc

验证安装是否成功：

dart --version

如果输出类似 Dart SDK version: 3.5.3，则表示配置完成。如果仍然报“command not found”，请检查 ~/.bashrc 文件末尾两行是否有拼写错误——特别注意 DART_SDK 和 $DART_SDK/bin 中的下划线与美元符号，不能遗漏或写错。

验证Dart运行能力

最后创建一个测试文件并运行：

echo "void main() { print('Hello from Dart on UOS'); }" > hello.dart
dart hello.dart

终端应准确输出 Hello from Dart on UOS。这一步不可跳过——某些UOS镜像默认禁用了 exec 权限，如果遇到 Permission denied 错误，请手动修复权限：

chmod +x ~/devtools/dart-sdk/dart-sdk/bin/dart

配置完成后，环境即准备就绪，可以开始编写Dart代码了。