name

中英双语

如果您计划发布您的包,那么 package.json 中*最重要的内容是名称和版本字段,因为它们是必需的。名称和版本共同构成一个假定完全唯一的标识符。对包的更改应该与版本的更改一起出现。如果您不打算发布您的包,名称和版本字段是可选的。

名字就是你的东西的名字。

一些规则:

  • 名称必须少于或等于 214 个字符。这包括范围包的范围。
  • 范围包的名称可以以点或下划线开头。没有范围是不允许的。
  • 新包的名称中不得包含大写字母。
  • 该名称最终成为 URL、命令行参数和文件夹名称的一部分。因此,名称不能包含任何非 URL 安全字符。

一些技巧:

  • 不要使用与核心 Node 模块相同的名称。
  • 不要在名称中添加 "js" 或 "node"。假设是js,因为你写的是package.json文件,你可以使用"engines"字段指定引擎。(见下文。)
  • 该名称可能会作为参数传递给 require(),所以它应该是简短的,但也是合理的描述性的。
  • 您可能需要检查 npm 注册表以查看是否已经存在该名称的内容,然后再过分依赖它。https://www.npmjs.com/

名称可以选择以范围为前缀,例如@myorg/mypackage。有关详细信息,请参见 scope