Visual Studio 2017中MSBUILD生成区域性附属程序集加载失败排查

嘿，我来帮你排查下这个附属程序集加载失败的问题——我之前做本地化的时候也踩过不少类似的坑，咱们一步步来捋清楚可能的原因：

1. 资源文件的属性配置大概率出了问题 #

这是最常见的坑，先检查你的资源文件属性：

• 对于默认资源strings.resx：确保生成操作设为嵌入的资源，自定义工具是ResXFileCodeGenerator（这个工具会自动生成对应的资源访问类，帮你处理附属程序集的加载逻辑）。
• 对于德语资源strings.de.resx：同样要把生成操作设为嵌入的资源，绝对不能设成无或者其他——要是这个属性错了，MSBuild根本不会把它打包成附属程序集。
• 还要注意文件名的大小写一致性：比如别把默认资源写成Strings.resx，本地化资源写成strings.de.resx，大小写不匹配会导致资源匹配失败。

2. 后期生成事件的MSBuild命令可能有错误 #

你提到用了后期生成事件调用MSBuild，这里很容易踩路径或者参数的坑：

• 先确认你硬编码的MSBuild路径是不是VS2017对应的版本：VS2017的MSBuild通常在C:\Program Files (x86)\Microsoft Visual Studio\2017\[你的版本，比如Community]\MSBuild\15.0\Bin，路径错了的话，命令根本不会执行，自然生成不了附属程序集。
• 建议用VS的内置宏代替硬编码路径，比如改成：

  "$(MSBuildBinPath)\MSBuild.exe" "$(ProjectPath)" /t:GenerateSatelliteAssemblies /p:Configuration=$(Configuration),Platform=$(Platform)
  

  这样能保证命令和当前项目的构建配置（Debug/Release、x86/x64）完全匹配，避免生成的文件放错位置。

3. 附属程序集的输出位置不对 #

附属程序集必须放在输出目录的区域性子文件夹里才能被正确加载：

• 去你的项目输出目录（比如bin\Debug）看看，有没有de文件夹？里面有没有[你的项目名].resources.dll这个文件？
  • 如果没有，说明生成过程没产出这个文件，回到前面的步骤检查资源属性和MSBuild命令。
  • 如果有这个文件但还是加载失败，那可能是你设置区域性的方式有问题，或者资源访问逻辑错了。

4. 区域性设置的姿势不对 #

切换区域性时，要注意两个关键点：

• 必须设置Thread.CurrentThread.CurrentUICulture，而不是CurrentCulture——CurrentCulture只影响数字、日期的格式，资源加载看的是CurrentUICulture。比如正确的代码应该是：

  Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("de");
  

• 这个设置一定要在加载资源之前执行，比如放在程序的Main方法开头，或者窗体构造函数的最前面，不然资源已经加载完了，再改区域性也没用。

5. 资源访问的逻辑有问题 #

如果你是手动用ResourceManager加载资源，要确保构造参数正确：

• 比如ResourceManager的基名称必须和资源的嵌入名称一致，通常是[你的项目命名空间].strings（比如项目命名空间是MyApp，那就是MyApp.strings）。
• 更省心的方式是用自动生成的资源类（比如Strings.String1）来访问资源，这个类会自动处理附属程序集的加载，不用你手动写加载逻辑，出错概率低很多。

6. VS2017的缓存或项目配置异常 #

VS2017有时候会因为缓存或者项目文件的问题导致生成异常：

• 先试试清理解决方案（右键解决方案→清理），然后删除bin和obj文件夹，再重新构建整个项目——很多时候缓存问题会导致生成的文件不对。
• 可以打开项目文件（.csproj）看看资源相关的配置，确保本地化资源的节点里有<Culture>属性，比如：

  <EmbeddedResource Include="strings.de.resx">
    <Culture>de</Culture>
  </EmbeddedResource>
  

  如果没有这个属性，MSBuild可能不会把它识别为本地化资源，也就不会生成对应的附属程序集。

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