C#控制台应用无法读取辅助App.config配置文件问题

我之前也碰到过一模一样的问题，折腾了好一会儿才摸清楚门道，给你梳理几个最常见的排查点和解决方法：

• 检查辅助配置文件的格式是否正确
  这是最容易踩的坑！辅助配置文件不能包含完整的<configuration>根节点，只能保留<appSettings>节点及其内部内容。比如你的App-not-in-source-control.config应该写成这样：

  <appSettings>
    <!-- 这里写要补充或覆盖的键值对 -->
    <add key="OVERRIDE_TEST_KEY" value="Overridden Test Value" />
    <add key="NEW_AUX_KEY" value="Value from auxiliary config" />
  </appSettings>
  

  如果你的辅助文件里有<configuration>标签，程序会直接忽略它的内容。

• 确保辅助文件被复制到输出目录
  在Visual Studio里右键点击你的辅助配置文件，选择「属性」，把「复制到输出目录」设置为「如果较新则复制」或者「始终复制」。如果编译后输出目录（比如bin/Debug）里没有这个文件，程序运行时自然找不到它。

• 验证文件路径是否正确
  appSettings的file属性路径是相对于程序运行的输出目录，不是你的项目根目录。如果辅助文件直接放在项目根目录，设置好复制属性后，直接写文件名就行；如果放在子文件夹里，要写相对路径，比如file="Configs/App-not-in-source-control.config"。

• 确认读取方式正确
  要使用ConfigurationManager.AppSettings["KEY_NAME"]来读取配置值，而且别忘了在项目里引用System.Configuration程序集——控制台应用默认是没有引用这个的，右键项目→「添加引用」，找到并勾选System.Configuration。

• 检查键名的一致性
  辅助文件里的键名要和主配置里的完全一致才能覆盖，不过好在ConfigurationManager.AppSettings是大小写不敏感的，但为了避免不必要的问题，最好还是保持键名大小写完全匹配。

举个完整的例子：
主App.config片段：

<configuration>
  <appSettings file="App-not-in-source-control.config">
    <add key="THIS_IS_A_TEST_KEY" value="Original Test Value" />
  </appSettings>
</configuration>

辅助配置文件内容：

<appSettings>
  <add key="THIS_IS_A_TEST_KEY" value="Overridden Test Value" />
  <add key="NEW_KEY" value="New Value from Aux File" />
</appSettings>

读取代码：

using System;
using System.Configuration;

namespace ConsoleConfigDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var testVal = ConfigurationManager.AppSettings["THIS_IS_A_TEST_KEY"];
            var newVal = ConfigurationManager.AppSettings["NEW_KEY"];
            
            Console.WriteLine($"Test Key: {testVal}");
            Console.WriteLine($"New Key: {newVal}");
        }
    }
}

另外还有个小提醒：如果辅助文件不存在，程序不会抛出异常，只会读取主配置里的内容；如果辅助文件格式有误，也会直接忽略它的配置项。

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