Flutter中实现按钮触发文件夹选择保存文件及file_picker适用性咨询

先直接给你明确答案：完全可以用file_picker包来实现用户选择文件夹的需求，这也是Flutter生态里处理这类场景最常用的方案之一。下面一步步带你完成整个流程：

1. 引入依赖 #

首先在你的pubspec.yaml文件中添加file_picker的依赖：

dependencies:
  flutter:
    sdk: flutter
  file_picker: ^5.3.2 # 可以替换为最新版本

执行flutter pub get完成依赖安装。

2. 实现文件夹选择与文件保存功能 #

下面是完整的页面代码示例，包含"选择文件夹"和"保存文件"两个核心按钮的逻辑：

import 'package:flutter/material.dart';
import 'package:file_picker/file_picker.dart';
import 'dart:io';

class FileSavePage extends StatefulWidget {
  const FileSavePage({super.key});

  @override
  State<FileSavePage> createState() => _FileSavePageState();
}

class _FileSavePageState extends State<FileSavePage> {
  String? _selectedFolderPath;

  // 触发文件夹选择弹窗
  Future<void> _pickFolder() async {
    String? folderPath = await FilePicker.platform.getDirectoryPath(
      dialogTitle: '请选择文件保存的文件夹',
      lockParentWindow: true, // 锁定窗口直到用户完成选择（可选）
    );

    if (folderPath != null) {
      setState(() {
        _selectedFolderPath = folderPath;
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(content: Text('已选中文件夹：$folderPath')),
        );
      });
    }
  }

  // 将内容保存到选中的文件夹
  Future<void> _saveFile() async {
    if (_selectedFolderPath == null) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('请先选择保存文件夹哦')),
      );
      return;
    }

    // 自定义文件名和内容
    const fileName = 'my_flutter_file.txt';
    const fileContent = '这是通过Flutter保存的文件内容！';

    final file = File('$_selectedFolderPath/$fileName');
    try {
      await file.writeAsString(fileContent);
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('文件已保存：${file.path}')),
      );
    } catch (e) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('保存失败：$e')),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('选择文件夹保存文件')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            ElevatedButton(
              onPressed: _pickFolder,
              child: const Text('选择保存文件夹'),
            ),
            const SizedBox(height: 16),
            if (_selectedFolderPath != null)
              Text('当前选中：$_selectedFolderPath'),
            const SizedBox(height: 32),
            ElevatedButton(
              onPressed: _saveFile,
              child: const Text('保存文件'),
            ),
          ],
        ),
      ),
    );
  }
}

3. 平台权限配置（必做） #

不同平台需要配置对应的权限才能正常访问文件系统：

• Android：
  在android/app/src/main/AndroidManifest.xml中添加权限：

  <!-- Android 10及以下需要的写入权限 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <!-- Android 11+ 访问全外部存储需要的权限 -->
  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  

  注意：MANAGE_EXTERNAL_STORAGE需要用户手动在应用设置中开启，你可以在代码里添加引导用户跳转设置的逻辑。

• iOS：
  在ios/Runner/Info.plist中添加以下配置，允许应用访问系统文件浏览器：

  <key>UISupportsDocumentBrowser</key>
  <true/>
  <key>LSSupportsOpeningDocumentsInPlace</key>
  <true/>
  

4. 额外说明 #

• 如果只是需要保存到应用默认目录（比如私有文档文件夹），可以用path_provider包，但你的需求是让用户手动选择路径，所以file_picker是更合适的选择。
• file_picker还支持自定义弹窗标题、限制选择特定目录等，你可以根据需求调整getDirectoryPath的参数。

内容的提问来源于stack exchange，提问作者Murali Krishnan