为了帮助其他人找到您在 npm 上的包并在他们的项目中使用您的代码时拥有良好的体验,我们建议在您的包目录中包含一个 README 文件。您的 README 文件可能包括有关安装、配置和使用包中代码的说明,以及用户可能觉得有用的任何其他信息。README 文件将在包页面上显示。

npm 包的 README 文件必须位于包的根目录。

创建并向包中添加 README.md 文件

  1. 在文本编辑器中,在您的包根目录中,创建一个名为 README.md 的文件。
  2. README.md 文件中,添加有关您的包的有用信息。
  3. 保存 README.md 文件。

注意: 文件扩展名 .md 表示 Markdown 文件。有关 Markdown 的更多信息,请参见 GitHub 指南“Markdown 精通”。

更新现有包的 README 文件

只有在您发布包的新版本时,README 文件才会在包页面上更新。要更新您的 README 文件

  1. 在文本编辑器中,更新 README.md 文件的内容。

  2. 保存 README.md 文件。

  3. 在命令行中,在包根目录中,运行以下命令

    npm version patch
    npm publish