npm命令

npm create

create命令是init命令的别名，npm init等同于npm create。

npm init

使用npm init命令初始化项目

初始化空nodejs项目（生成package.json文件）

npm init

添加index.mjs文件内容如下：

// NOTE: 文件只有命名为index.mjs才能够使用 yarn test 运行，
// 否则报告 "Cannot use import statement outside a module" 错误

import moment from "moment";

console.log(`当前时间: ${moment().format("YYYY-MM-DD HH:mm:ss")}`)

添加monent开发环境依赖

npm install moment --save-dev

编辑package.json文件最终内容如下：

{
  "name": "demo-nodejs-project-init-by-using-npm",
  "version": "1.0.0",
  "description": "``` # 初始化空nodejs项目(生成package.json文件) ```",
  "main": "index.js",
  "scripts": {
    "test": "node ./index.mjs"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "moment": "^2.29.4"
  }
}

运行项目

node index.mjs

npm init <initializer>

链接

npm init <initializer>可用于设置新的或现有的npm包。

在这种情况下，initializer是一个名为create-<initializer>的npm包，它将由npx安装，然后执行其主bin——大概是创建或更新package.json并运行任何其他与初始化相关的操作。

init命令转换为相应的npx操作，如下所示：

• npm init foo -> npx create-foo
• npm init @usr/foo -> npx @usr/create-foo
• npm init @usr -> npx @usr/create

任何其他选项都将直接传递给命令，因此npm init foo --hello将映射到npx create-foo --hello。

如果省略初始化程序（只需调用npm init），init将恢复为旧的init行为。它会问你一堆问题，然后为你写一个package.json。它将尝试根据现有字段、依赖项和所选选项做出合理的猜测。它是严格附加的，因此它将保留已设置的任何字段和值。您还可以使用-y/--yes完全跳过问卷调查。如果您传递--scope，它将创建一个范围包。

使用create-react-app创建一个基于React的新项目：

npm init react-app ./my-react-app

使用create-esm创建一个与esm兼容的新包：

mkdir my-esm-lib && cd my-esm-lib
npm init esm --yes

npm和npx区别

npm vs npx — What’s the Difference?

npm（node包管理器）是安装Node.js时随附的依赖项/包管理器。它为开发人员提供了一种全局和本地安装包的方法。

有时您可能想查看特定包并尝试一些命令。但如果不在本地node_modules文件夹中安装依赖项，则无法执行此操作。

这就是npx发挥作用的地方。

npm本身不运行任何包。如果要使用npm运行包，则必须在package.json文件中指定该包。

当可执行文件通过npm软件包安装时，npm会创建指向它们的链接：

• 本地安装在./node_modules/.bin/目录中创建链接
• 全局安装在全局bin/目录中创建链接（例如：Linux上的/usr/local/bin或Windows上的%AppData%/npm）

要使用npm执行包，您必须输入本地路径，如下所示：

./node_modules/.bin/your-package

或者您可以通过将其添加到package.json文件中的脚本部分来运行本地安装的包，如下所示：

{
  "name": "your-application",
  "version": "1.0.0",
  "scripts": {
    "your-package": "your-package"
  }
}

然后您可以使用npm run运行脚本：

npm run your-package

您可以看到，使用普通的npm运行包需要相当多的手续。

幸运的是，这正是npx派上用场的地方。

您可以运行以下命令来查看npx是否已安装在您当前的npm版本中：

which npx

如果没有，你可以像这样安装：

npm install -g npx

如果您希望执行本地安装的包，您只需输入：

npx your-package

npx将检查<command>或<package>是否存在于$PATH或本地项目二进制文件中，如果存在，则执行它。

另一个主要优点是能够执行以前未安装的包。

让我们通过运行来测试一下：

npx cowsay wow

这很棒，因为有时您只想使用一些CLI工具，但不想为了测试而全局安装它们。

这意味着您可以节省一些磁盘空间，只在需要时运行它们。这也意味着您的全局变量将受到更少的污染。

让我们使用npx尝试create-react-app的下一个dist标签，它将在沙盒目录中创建应用程序。

npx create-react-app@next sandbox

npx将临时安装create-react-app的下一个版本，然后执行它来搭建应用程序并安装其依赖项。

安装完成后，我们可以像这样导航到该应用程序：

cd sandbox

然后使用以下命令启动它：

npm start

它将自动在您的默认浏览器窗口中打开React应用程序。 现在我们有一个在create-react-app包的下一个版本上运行的应用程序！

npm install

• 调试npm install

  https://dev.to/matheusabr/enhance-your-npm-installations-with-loglevel-26cc

  npm install --verbose

• npm install 时指定 registry

  https://stackoverflow.com/questions/35622933/how-to-specify-registry-while-doing-npm-install-with-git-remote-url

  sudo npm install -g create-nuxt-app@2.15.0 --registry=https://registry.npmmirror.com

npm link

注意：不知道什么原因，在一个测试项目中想 npm link 两个自定义组件库失败（npm link 第二个自定义组件库时会自动删除前一个）。考虑到实际场景中没有需求同时开发两个自定义组件库所以对此问题不作深入研究。

npm link 的主要作用是允许开发者在本地开发环境中，将自定义的 npm 模块链接到全局或其他项目中，以便在不发布到 npm 仓库的情况下进行测试和调试。这一功能并不限制链接的库的数量。

具体来说，你可以使用 npm link 将多个本地开发的 npm 模块链接到全局，然后在不同的项目中通过 npm link <模块名> 命令引用这些模块。这样，你就可以在同一个开发环境中同时测试和使用多个本地模块。

例如：

1. 创建全局链接：
   • 假设你有两个本地开发的 npm 模块 moduleA 和 moduleB。
   • 进入 moduleA 的目录，运行 npm link 命令，将 moduleA 链接到全局。
   • 进入 moduleB 的目录，运行 npm link 命令，将 moduleB 链接到全局。
2. 在项目中使用链接的模块：
   • 进入你希望使用这些模块的项目目录。
   • 运行 npm link moduleA 命令，将全局链接的 moduleA 链接到该项目的 node_modules 目录中。
   • 运行 npm link moduleB 命令，将全局链接的 moduleB 链接到该项目的 node_modules 目录中。

此时，你的项目中就可以同时使用 moduleA 和 moduleB 这两个本地开发的 npm 模块了。

需要注意的是，由于 npm link 创建的是符号链接（在 Windows 中类似于快捷方式），因此修改任何一个链接模块的源代码都会实时反映在所有链接了该模块的项目中。这有助于开发者在开发过程中快速迭代和调试。

此外，虽然 npm link 支持同时链接多个库，但在实际使用中仍需注意以下几点：

1. 依赖冲突：
   • 如果多个链接的库之间存在依赖冲突，可能会导致项目运行出现问题。因此，在链接多个库之前，最好先检查它们的依赖关系。
2. 版本管理：
   • 使用 npm link 时，链接的是本地模块当前目录的代码。因此，如果本地模块的代码发生变化，这些变化会立即反映在所有链接了该模块的项目中。这有助于快速迭代和调试，但也要求开发者在修改代码时格外小心。
3. 权限问题：
   • 在某些系统上（如 Linux 或 macOS），创建全局符号链接可能需要管理员权限。如果遇到权限问题，可以尝试使用 sudo npm link 命令。
4. 解除链接：
   • 如果不再需要使用 npm link，可以使用 npm unlink <模块名> 命令来解除模块在项目中的链接，使用 npm unlink 命令（在模块目录中）来解除模块的全局链接。

综上所述，npm link 支持同时链接多个库，但在实际使用中需要注意依赖冲突、版本管理、权限问题以及解除链接等操作。