如何为Outlook VSTO加载项部署配套JSON文件？

一、排查文件未复制到输出目录的问题 #

如果已经设置文件属性但仍未生效，按以下步骤检查：

• 确认文件属性配置：选中JSON文件右键→属性，确保复制到输出目录设为「始终复制」或「如果较新则复制」，生成操作设为「内容」。也可以直接打开项目文件（.csproj），检查是否存在对应配置项：

  <Content Include="你的文件名.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
  

  若缺失，手动添加后保存项目。
• 验证输出目录路径：Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location)返回的是加载项程序集的实际加载路径，调试状态下通常在bin/Debug或bin/Release，发布后可能位于用户的AppData或Office加载项目录，不要混淆项目开发目录和实际输出目录。
• 清理重建项目：执行「解决方案→清理」，再「生成」，避免Visual Studio缓存导致文件未复制。

二、更适合的用户数据存储方案 #

注意：程序集目录通常是只读的（如部署到Program Files下），且加载项更新时会覆盖该目录，完全不适合存储用户个性化数据。推荐采用用户专属的本地存储路径：

1. 选择合适的用户存储目录 #

优先使用系统提供的用户专属文件夹：

• Environment.SpecialFolder.ApplicationData：对应C:\Users\[用户名]\AppData\Roaming，数据随用户账号漫游，适合跨设备同步的配置。
• Environment.SpecialFolder.LocalApplicationData：对应C:\Users\[用户名]\AppData\Local，仅本地存储，适合不需要漫游的大文件或临时数据。

2. 嵌入JSON文件到程序集（无需单独分发） #

将JSON文件作为嵌入资源打包到程序集，第一次运行时复制到用户目录：

• 选中JSON文件，右键→属性，设置生成操作为「嵌入的资源」。
• 使用以下代码完成初始化与读写：

  // 定义用户数据文件路径
  var appDataDir = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
  var addinDataDir = Path.Combine(appDataDir, "你的加载项名称");
  var userDataFile = Path.Combine(addinDataDir, "data.json");
  
  // 创建目录（如果不存在）
  if (!Directory.Exists(addinDataDir))
  {
      Directory.CreateDirectory(addinDataDir);
  }
  
  // 首次运行时从嵌入资源复制文件
  if (!File.Exists(userDataFile))
  {
      var assembly = Assembly.GetExecutingAssembly();
      // 资源名称格式：项目命名空间 + 文件路径（含子目录），例如"OutlookAddin1.data.json"
      var resourceName = "你的项目命名空间.你的文件名.json";
      
      using (var resourceStream = assembly.GetManifestResourceStream(resourceName))
      using (var fileStream = new FileStream(userDataFile, FileMode.Create))
      {
          resourceStream.CopyTo(fileStream);
      }
  }
  
  // 后续直接读写userDataFile路径即可
  

3. 优势 #

• 无需单独分发JSON文件，打包在程序集内，部署更简单。
• 用户数据独立存储，不会被加载项更新覆盖，且每个用户的数据互不干扰。
• 拥有合法的读写权限，避免权限不足导致的异常。

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