类库引用失败主因是目标框架不匹配和类型可见性不足；应统一用.NET Standard 2.0或匹配主项目版本，所有对外成员须显式声明public，并正确配置PackageId、Version及传递依赖。
创建类库项目时选错目标框架会直接导致引用失败
新建类库却在其他项目里引用不了，大概率是目标框架不匹配。比如类库选了 .NET 6，而主项目还是 .NET Framework 4.7.2，编译器会直接报 The type or namespace name 'xxx' could not be found，不是代码问题，是根本没加载进来。
实操建议：
- 统一用
.NET Standard 2.0（兼容.NET Framework 4.6.1+和.NET Core 2.0+），除非你明确只跑新环境 - 如果主项目是
.NET 5/6/7/8，类库优先选对应版本，避免隐式转换或 API 不可用 - VS 新建时别只点“类库”，务必展开模板，选带
.NET Standard或.NET Class Library的具体项，而不是老的Class Library (.NET Framework)
类库中 public 修饰符漏写，外部项目调用时类型不可见
类、方法、属性默认是 internal，即使生成了 .dll，其他项目也看不到——不是报错，而是智能提示里压根不出现，using 之后也没类型补全，容易误以为引用没生效。
实操建议：
- 所有要对外暴露的类必须显式加
public，包括构造函数（否则 new 不出来） - 公共方法如果返回自定义类型，那个类型也得是
public，否则调用方看到的是object或编译错误 - 用
dotnet build后检查输出目录的.dll，用ildasm或 JetBrains dotPeek 打开，确认类型和成员确实是public
发布 NuGet 包前没设 PackageId 和 Version 会导致安装失败
类库项目右键“打包”生成 .nupkg，但别人 Install-Package 时提示找不到包，常见原因是 .csproj 里没配 PackageId，或者 Version 是占位符如 1.0.0-ci，NuGet 默认不接受预发布版本（除非加 -IncludePrerelease）。
实操建议：
- 在
.csproj的<propertygroup></propertygroup>里加两行：<packageid>MyUtils</packageid><version>1.0.0</version> - 避免用
AssemblyVersion替代Version，前者影响运行时绑定，后者才决定 NuGet 包名和版本号 - 本地测试用
dotnet pack -o ./nupkgs，再用dotnet add package MyUtils --source ./nupkgs验证能否装上
类库依赖第三方包后，调用方没自动获得传递依赖
你的类库引用了 Newtonsoft.Json，但主项目没手动装它，运行时报 Could not load file or assembly 'Newtonsoft.Json'——.NET SDK 默认不自动传播 PackageReference，除非你显式标记为“可传递”。
实操建议：
- 在类库的
.csproj中，给依赖项加上PrivateAssets="all"（默认行为，安全）或IncludeAssets="compile;runtime"（需传递时） - 更稳妥的做法：类库内部尽量封装掉第三方类型，比如不要让 public 方法直接返回
JObject，改用string或自定义 DTO - 若必须暴露第三方类型，就在类库项目文件里加：
<packagereference include="Newtonsoft.Json" version="13.0.3" generatepathproperty="true"></packagereference>，再配合<frameworkreference include="Microsoft.NETCore.App"></frameworkreference>明确运行时依赖
