dio 是 Flutter 中一个非常流行的网络请求库，它支持多种功能，如拦截器、请求取消、文件上传/下载、超时设置等。下面是如何在 Flutter 项目中使用 dio 进行网络请求的基本步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 dio 依赖：

dependencies:
  flutter:
    sdk: flutter
  dio: ^5.0.0  # 请根据最新版本号进行更新

然后运行 flutter pub get 来安装依赖。

2. 创建 Dio 实例

在你的 Dart 文件中，导入 dio 并创建一个 Dio 实例：

import 'package:dio/dio.dart';

final dio = Dio();

3. 发起 GET 请求

使用 dio.get 方法发起一个 GET 请求：

void fetchData() async {
  try {
    final response = await dio.get('https://jsonplaceholder.typicode.com/posts/1');
    print(response.data);
  } catch (e) {
    print('Error: $e');
  }
}

4. 发起 POST 请求

使用 dio.post 方法发起一个 POST 请求：

void postData() async {
  try {
    final response = await dio.post(
      'https://jsonplaceholder.typicode.com/posts',
      data: {
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      },
    );
    print(response.data);
  } catch (e) {
    print('Error: $e');
  }
}

5. 设置请求头

你可以通过 options 参数来设置请求头：

void fetchDataWithHeaders() async {
  try {
    final response = await dio.get(
      'https://jsonplaceholder.typicode.com/posts/1',
      options: Options(headers: {
        'Authorization': 'Bearer your_token_here',
      }),
    );
    print(response.data);
  } catch (e) {
    print('Error: $e');
  }
}

6. 拦截器

dio 支持拦截器，你可以在请求发送前或响应返回后进行一些操作：

dio.interceptors.add(InterceptorsWrapper(
  onRequest: (options, handler) {
    // 在请求发送前做一些操作
    print('Request: ${options.uri}');
    return handler.next(options);
  },
  onResponse: (response, handler) {
    // 在响应返回后做一些操作
    print('Response: ${response.data}');
    return handler.next(response);
  },
  onError: (DioError e, handler) {
    // 在请求出错时做一些操作
    print('Error: $e');
    return handler.next(e);
  },
));

7. 文件上传

使用 dio 上传文件：

void uploadFile() async {
  try {
    final formData = FormData.fromMap({
      'file': await MultipartFile.fromFile('path/to/file.txt', filename: 'file.txt'),
    });
    final response = await dio.post(
      'https://example.com/upload',
      data: formData,
    );
    print(response.data);
  } catch (e) {
    print('Error: $e');
  }
}

8. 文件下载

使用 dio 下载文件：

void downloadFile() async {
  try {
    final response = await dio.download(
      'https://example.com/file.txt',
      'path/to/save/file.txt',
    );
    print('File downloaded');
  } catch (e) {
    print('Error: $e');
  }
}

9. 取消请求

你可以使用 CancelToken 来取消请求：

void fetchDataWithCancel() async {
  final cancelToken = CancelToken();

  try {
    final response = await dio.get(
      'https://jsonplaceholder.typicode.com/posts/1',
      cancelToken: cancelToken,
    );
    print(response.data);
  } catch (e) {
    if (CancelToken.isCancel(e)) {
      print('Request canceled');
    } else {
      print('Error: $e');
    }
  }

  // 取消请求
  cancelToken.cancel();
}

10. 设置超时

你可以通过 options 参数设置请求超时时间：

void fetchDataWithTimeout() async {
  try {
    final response = await dio.get(
      'https://jsonplaceholder.typicode.com/posts/1',
      options: Options(
        sendTimeout: Duration(seconds: 5),
        receiveTimeout: Duration(seconds: 5),
      ),
    );
    print(response.data);
  } catch (e) {
    print('Error: $e');
  }
}