VSTO Word加载项ClickOnce部署时输出文件夹可配置化方案咨询

我之前在部署VSTO项目时也遇到过ClickOnce不包含app.config的情况——这是因为ClickOnce对配置文件的处理逻辑和普通.NET应用完全不同。给你几个实用的解决方案，按推荐程度排序：

1. 使用ClickOnce内置的应用程序设置（推荐） #

这是最贴合ClickOnce部署模型的方案，步骤清晰且维护成本低：

• 打开项目的Properties文件夹，双击Settings.settings文件
• 添加一个新设置项：
  • 名称：比如OutputFolder
  • 类型：string
  • 范围：选User（允许普通用户自行修改）或Application（仅管理员可修改，适合固定环境批量配置）
  • 默认值：填入开发阶段使用的默认文件夹路径
• 在代码中调用这个设置：

  string outputPath = Properties.Settings.Default.OutputFolder;
  // 如果允许用户修改，修改后记得保存配置
  Properties.Settings.Default.OutputFolder = newSelectedPath;
  Properties.Settings.Default.Save();
  

• 发布后配置方式：
  • 若为User范围：可以在加载项里加一个简单的设置界面，让用户手动选择或输入文件夹
  • 若为Application范围：可用mage.exe工具修改ClickOnce部署清单中的设置值，或者针对不同环境修改Settings.settings后重新发布

2. 自定义独立配置文件 #

如果不想依赖ClickOnce的内置设置机制，可以自己创建一个可编辑的配置文件：

• 选择用户可轻松访问的存储路径，比如文档文件夹或AppData：

  string configPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "WordAddinConfig.json");
  

• 加载项启动时检查文件是否存在：不存在则生成带默认路径的配置文件，存在则读取其中的输出路径
• 用JSON或XML序列化工具读写配置，示例（用JSON）：

  // 定义配置类
  public class AddinConfig
  {
      public string OutputFolder { get; set; } = @"C:\DefaultOutput";
  }
  
  // 读取配置逻辑
  AddinConfig config;
  if (File.Exists(configPath))
  {
      string jsonContent = File.ReadAllText(configPath);
      config = JsonConvert.DeserializeObject<AddinConfig>(jsonContent);
  }
  else
  {
      config = new AddinConfig();
      File.WriteAllText(configPath, JsonConvert.SerializeObject(config, Formatting.Indented));
  }
  

• QA或用户可以直接编辑这个JSON文件修改路径，灵活性拉满

3. 使用环境变量 #

适合需要批量部署到多环境的场景，无需修改任何配置文件：

• 在目标环境（QA/生产）设置系统或用户环境变量，比如WORD_ADDIN_OUTPUT_FOLDER
• 代码中读取环境变量，同时保留默认路径作为 fallback：

  string outputPath = Environment.GetEnvironmentVariable("WORD_ADDIN_OUTPUT_FOLDER") 
                      ?? @"C:\DefaultOutput";
  

• 运维人员只需在不同环境设置对应的环境变量即可，完全不用改动应用本身

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