| ms.openlocfilehash | c92f6e0c34347ee8555d416140d95ea2df5a3fbb |
|---|---|
| ms.sourcegitcommit | 2b50c450cca521681a384aa466ab666679a40213 |
| ms.translationtype | HT |
| ms.contentlocale | zh-CN |
| ms.lasthandoff | 04/07/2020 |
| ms.locfileid | 73610552 |
包标识符和版本号是项目中最重要的两个值，因为它们唯一标识包中包含的确切代码。
针对包标识符的最佳做法：
- 唯一性：标识符必须在 nuget.org 或托管包的任意库中是唯一的。 确定标识符之前，请搜索适用库以检查该名称是否已使用。 为了避免冲突，最好使用公司名作为标识符的第一部分（例如
Contoso.）。 - 类似于命名空间的名称：遵循类似于 .NET 中命名空间的模式，使用点表示法（而不是连字符）。 例如，使用
Contoso.Utility.UsefulStuff而不是Contoso-Utility-UsefulStuff或Contoso_Utility_UsefulStuff。 当包标识符与代码中使用的命名空间相匹配时，这个方法也很有用。 - 示例包：如果生成展示如何使用另一个包的示例代码包，请附加
.Sample作为标识符的后缀，就像Contoso.Utility.UsefulStuff.Sample中一样。 （当然，示例包会在其他包上有依赖项。）创建示例包时，请在<IncludeAssets>中使用contentFiles值。 在content文件夹中，在名为\Samples\<identifier>的文件夹中排列示例代码，与\Samples\Contoso.Utility.UsefulStuff.Sample中相似。
针对包版本的最佳做法：
- 一般情况下，将包的版本设置为与项目（或程序集）相匹配，但这不是必须的。 如果将包限制为单个程序集，那么这是一个简单的问题。 总的来说，请记住解析依赖项时，NuGet 自己处理包版本而不是程序集版本。
- 使用非标准版本方案时，请确保考虑使用 NuGet 版本控制规则，如包版本控制中所述。 NuGet 主要与 semver 2 兼容。
有关依赖项解析的信息，请参阅使用 PackageReference 的依赖项解析。 对于可能有助于更好地理解版本控制的较旧信息，请参阅此系列博客文章。