Flutter中如何自定义PDF文档的保存文件名？

DevOps 小满

2026-7-29

解决Flutter中自定义PDF保存文件名的问题

你的generateDocument方法仅负责生成PDF的字节数据，文件名并非在此阶段设置，而是在将字节数据写入本地文件或分享文件时指定。以下是两种常见场景的实现方案：

场景1：保存PDF到本地设备（如下载文件夹）

借助path_provider包获取系统目录，具体步骤如下：

在pubspec.yaml中添加依赖：

dependencies:
  path_provider: ^2.1.2

实现自定义文件名的保存逻辑：

import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<void> saveCustomNamedPdf() async {
  // 调用你的PDF生成方法获取字节数据
  final pdfBytes = await generateDocument(PdfPageFormat.a4);
  
  // 获取设备的下载目录
  final downloadsDir = await getDownloadsDirectory();
  if (downloadsDir == null) return;

  // 自定义文件名，此处设置为Mydocument.pdf
  final targetFile = File('${downloadsDir.path}/Mydocument.pdf');
  // 将字节数据写入文件
  await targetFile.writeAsBytes(pdfBytes);

  // 可添加保存成功提示，比如使用fluttertoast等工具包
}

场景2：分享自定义名称的PDF

使用share_plus包实现分享，步骤如下：

在pubspec.yaml中添加依赖：

dependencies:
  share_plus: ^7.2.2

实现带自定义文件名的分享逻辑：

import 'dart:io';
import 'package:share_plus/share_plus.dart';
import 'package:path_provider/path_provider.dart';

Future<void> shareCustomNamedPdf() async {
  final pdfBytes = await generateDocument(PdfPageFormat.a4);
  
  // 获取临时目录存储待分享的PDF
  final tempDir = await getTemporaryDirectory();
  final tempFile = File('${tempDir.path}/Mydocument.pdf');
  await tempFile.writeAsBytes(pdfBytes);

  // 分享文件，自定义文件名会在分享选项中显示
  await Share.shareXFiles(
    [XFile(tempFile.path)],
    text: '分享自定义名称的PDF',
  );
}