Android：如何存储JSON文件以同时支持应用与用户访问？

核心原则：选择用户可访问+应用可读写的公共存储区域 #

内部存储（比如Android应用私有目录、iOS沙盒非共享目录）只有应用自身能操作，用户没法手动放入文件，所以必须选外部/公共存储区域——这类区域用户可通过文件管理器、USB传输、系统文件应用等方式操作，同时应用有权限读取。

分平台的通用路径与实现建议 #

Android 平台

• 推荐存储位置：公共Documents目录（文件管理器显示为「文档」文件夹），或自定义的公共子目录（比如文档/你的应用名/）
  • 绝对路径示例：/storage/emulated/0/Documents/app_config.json
• 权限说明：
  • Android 10及以上：借助Scoped Storage，无需申请READ_EXTERNAL_STORAGE权限即可直接读取公共Documents目录的文件；自定义目录需由应用先创建，再引导用户放入文件
  • Android 9及以下：需在Manifest中声明READ_EXTERNAL_STORAGE权限，并引导用户授权
• 读取伪代码（Java）：

  File configFile = new File(
      Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS),
      "app_config.json"
  );
  // 后续通过FileInputStream读取文件内容并解析为JSON
  

iOS 平台

• 推荐存储位置：应用专属Documents目录（需开启文件共享）
  • 用户无需记住路径，打开系统「文件」应用找到你的应用文件夹，直接放入JSON文件即可
• 配置步骤：在Xcode项目的Info.plist中添加UIFileSharingEnabled键并设为YES，开启文件共享功能
• 读取伪代码（Swift）：

  guard let documentsDir = FileManager.default.urls(
      for: .documentDirectory,
      in: .userDomainMask
  ).first else { return }
  let configFile = documentsDir.appendingPathComponent("app_config.json")
  // 后续通过Data(contentsOf: configFile)读取并解析JSON
  

桌面端（Windows/macOS/Linux）

• 推荐存储位置：用户可见的「文档」目录下的应用专属文件夹，兼顾易找性和规范性
  • Windows：C:\Users\<用户名>\Documents\你的应用名\app_config.json 或 %APPDATA%\你的应用名\app_config.json（后者为隐藏配置目录）
  • macOS：~/Documents/你的应用名/app_config.json 或 ~/Library/Application Support/你的应用名/app_config.json
  • Linux：~/Documents/你的应用名/app_config.json 或 ~/.config/你的应用名/app_config.json
• 读取伪代码（Python）：

  import json
  from pathlib import Path
  
  config_path = Path.home() / "Documents" / "你的应用名" / "app_config.json"
  if config_path.exists():
      with open(config_path, 'r', encoding='utf-8') as f:
          config = json.load(f)
  

额外提示 #

1. 给用户明确操作指引：比如提示「请创建名为app_config.json的文件，填入参数后放到设备的「文档」文件夹中」
2. 应用启动时先检查配置文件是否存在，不存在则给出友好提示，避免崩溃
3. 尽量避免系统隐藏目录，除非需要用户无感知的配置存储，否则用户很难找到并修改文件

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