npm 的 package.json 简介

描述

关于 package.json 文件中需要的内容,您只需要了解这个文档。
它必须是标准的JSON,而不是JavaScript对象字面量。

本文档中描述的许多行为都受到npm-config中描述的配置设置的影响。

name

如果您计划发布包,那么包中最重要的部分。json是名称和版本字段,因为它们是必需的。名称和版本一起构成一个标识符,该标识符被认为是完全惟一的。对包的更改应该与对版本的更改一起出现。如果不打算发布包,名称和版本字段是可选的。
名字就是你的东西的名字。

规则

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

小贴士

  • 不要使用与核心节点模块相同的名称。
  • 不要在名称中使用“js”或“node”。假设它是js,因为您正在编写一个包。json文件,您可以使用“engine”字段指定引擎。(见下文)。
  • 名称可能会作为参数传递给require(),所以它应该是简短的,但也应该是合理的描述性的。
  • 在过于依赖npm注册表之前,您可能希望检查npm注册表,看看是否已经有了这个名称。https://www.npmjs.com/

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

version

如果您计划发布包,那么包中最重要的部分。json是名称和版本字段,因为它们是必需的。名称和版本一起构成一个标识符,该标识符被认为是完全惟一的。对包的更改应该与对版本的更改一起出现。如果不打算发布包,名称和版本字段是可选的。

版本必须由node-semver解析,它与npm绑定为依赖项。(npm install semver to use it yourself.)

更多关于版本号和范围的信息请访问semver.

description

在里面放一段描述。它是一个字符串。这有助于人们发现你的包,因为它列在 npm search 结果里。

keywords

输入关键词。它是一个字符串数组。这有助于人们发现您的包,因为它列在npm search 结果里。

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • 这里只截取了部分常用的选项,全部内容戳这里 概述 注意package.json必须是纯JSON的,而不仅仅是一个J...
    叶夏星辰阅读 1,909评论 0 0
  • 概要 64学时 3.5学分 章节安排 电子商务网站概况 HTML5+CSS3 JavaScript Node 电子...
    阿啊阿吖丁阅读 9,894评论 0 3
  • 前言 package.json是每个npm包、基于node的项目中必不可少的配置文件,这里将详细介绍出现在pack...
    ITgecko阅读 4,191评论 0 4
  • 去年有段时间得空,就把谷歌GAE的API权威指南看了一遍,收获颇丰,特别是在自己几乎独立开发了公司的云数据中心之后...
    骑单车的勋爵阅读 21,142评论 0 41
  • 史睿辰头疼的看着眼前的作业,唉~每天都是这样,白天被老师骂,晚上又要写作业。。 她无精打采的趴在桌上,没错,她是一...
    苏格拉一没有底阅读 141评论 0 0

友情链接更多精彩内容