npm link 基本使用

npm link 是一个非常有用的命令，用于在开发过程中将本地 npm 包链接到全局 npm 目录，从而可以在其他项目中使用这个本地包，而不需要发布到 npm 仓库。这对于本地开发和测试非常有帮助。

npm link 的基本用法和步骤

  1. 在本地包目录中创建链接：

    首先，进入你要链接的本地包的目录，然后运行以下命令：

    1
    npm link

    这个命令会在全局 npm 目录中创建一个符号链接，指向你当前的本地包。

  2. 在项目中使用链接的包：
    接下来，进入你希望使用这个本地包的项目目录，然后运行以下命令：

    1
    npm link <package-name>

    其中 <package-name> 是你本地包的名称（通常在 package.json 文件中的 name 字段定义）。

    这个命令会在项目的 node_modules 目录中创建一个符号链接，指向全局 npm 目录中的本地包。

  3. 取消链接：
    如果你需要取消链接，可以按照以下步骤操作：

    • 在项目目录中运行以下命令，取消项目中的链接：

      1
      npm unlink <package-name>

    • 在本地包目录中运行以下命令，取消全局链接：

      1
      npm unlink

通过这些步骤，你可以在本地开发过程中方便地测试和调试 npm 包，而不需要每次都发布到 npm 仓库。

例如，我有一个本地插件hexo-footer-plugin想要在其他项目中引入依赖并使用

image-20240622132320004

进入到插件所属目录以管理员身份执行 npm link 创建链接

image-20240622132511743

创建的符号链接保存在全局 npm 目录中。具体来说，npm link 命令会在全局 node_modules 目录中创建一个符号链接，指向你本地包的目录。

全局 node_modules 目录的位置取决于你的操作系统和 npm 配置。通常情况下，它通常位于以下路径：

  • Linux/macOS: /usr/local/lib/node_modules
  • Windows: C:\Users\<YourUsername>\AppData\Roaming\npm\node_modules

你可以通过以下步骤来判断是否链接成功：

  1. 检查全局 node_modules 目录：
    你可以导航到全局 node_modules 目录，查看是否存在指向你本地包的符号链接。例如，在 Linux/macOS 上，你可以运行以下命令：

    1
    ls -l /usr/local/lib/node_modules

    在 Windows 上，你可以打开文件资源管理器并导航到 C:\Users\<YourUsername>\AppData\Roaming\npm\node_modules 目录。

  2. 在项目中检查 node_modules 目录：
    进入你的项目目录，查看 node_modules 目录中是否存在指向你本地包的符号链接。例如，你可以运行以下命令：

    1
    ls -l node_modules

    或者在 Windows 上，你可以打开文件资源管理器并导航到项目目录中的 node_modules 目录。

  3. 尝试导入和使用包：
    在你的项目中尝试导入和使用链接的包，看看是否能够成功加载和使用。例如，如果你链接了一个名为 my-package 的包，你可以在项目中这样使用：

    1
    2
    const myPackage = require('my-package');
    console.log(myPackage);

    如果能够成功加载并输出内容，说明链接成功。

通过这些方法，你可以确认 npm link 是否成功创建了符号链接，并且你的本地包是否可以在项目中正常使用。

如果在全局 node_modules 目录下没有看到刚才创建的符号链接，可以按照以下步骤进行排查：

  1. 确认全局 node_modules 目录位置：
    首先，确认全局 node_modules 目录的实际位置。你可以通过以下命令查看：

    1
    npm config get prefix

    这个命令会输出全局 npm 目录的前缀路径。然后你可以在这个路径下找到 lib/node_modules 目录。

  2. 检查符号链接是否创建成功：
    进入全局 node_modules 目录，查看是否存在符号链接。例如，如果你链接的包名为 my-package，你可以运行以下命令：

    1
    ls -l $(npm config get prefix)/lib/node_modules

    或者在 Windows 上，你可以打开文件资源管理器并导航到相应的目录。

  3. 检查权限：
    确保你有权限在全局 node_modules 目录中创建符号链接。如果没有权限，可以尝试使用 sudo（在 Linux/macOS 上）或者以管理员身份运行命令提示符（在 Windows 上）。

  4. 重新创建符号链接：
    如果符号链接没有创建成功，可以尝试重新创建。首先，在本地包目录中运行：

    1
    npm link

    然后，在项目目录中运行：

    1
    npm link my-package

  5. 检查 package.json 文件：
    确保你的本地包的 package.json 文件中正确设置了 name 字段，这个字段是你在项目中链接和使用的包名。

  6. 清除缓存：
    有时候，npm 缓存可能会导致问题。你可以尝试清除 npm 缓存并重新创建符号链接：

    1
    npm cache clean --force

    然后再次运行 npm link 和 npm link my-package。

通过这些步骤，你应该能够找到并确认符号链接是否成功创建。如果问题仍然存在，可以考虑查看 npm 的日志文件或者在 npm 的 GitHub 仓库中查找相关问题。

可以看到链接创建成功

image-20240622133510657

进入到项目目录以管理员身份执行命令npm link <package-name>以使用

image-20240622133906458

使用npm ls --link查看当前项目引入的链接

可以看到nodemodus目录已经引入了依赖文件

image-20240622134248348

要查看你的项目引入了哪些链接（即哪些包是通过 npm link 链接的），你可以按照以下步骤进行操作：

  1. 检查 node_modules 目录：
    进入你的项目目录，查看 node_modules 目录中的内容。符号链接的文件或目录会有特殊的标记，通常是 -> 符号，表示这是一个符号链接。

    例如，在 Linux/macOS 上，你可以运行以下命令：

    1
    ls -l node_modules

    在 Windows 上，你可以使用 dir 命令或者直接在文件资源管理器中查看。

  2. 使用 npm ls 命令：
    npm ls 命令可以列出项目中安装的所有包及其依赖关系。你可以使用 --link 标志来查看通过 npm link 链接的包。

    运行以下命令：

    1
    npm ls --link

    这个命令会显示所有通过 npm link 链接的包。

  3. 检查 package-lock.json 文件：
    package-lock.json 文件包含了项目中所有包的详细信息，包括它们的版本和来源。你可以打开这个文件，查找 link: true 的条目，这些条目表示通过 npm link 链接的包。

  4. 使用 npm list 命令：
    你也可以使用 npm list 命令来查看项目中安装的所有包，并结合 --depth=0 标志来简化输出。

    运行以下命令：

    1
    npm list --depth=0

    这个命令会列出项目中直接安装的包，你可以手动检查这些包是否是通过 npm link 链接的。

通过这些方法，你可以查看你的项目中引入了哪些链接的包，并确认它们是通过 npm link 链接的。

然后修改项目根目录package.json，添加插件依赖

image-20240622134805117

如果在 package.json 文件的 dependencies 部分确实没有引入链接的包，那么你需要手动添加这个依赖。以下是具体步骤：

  1. 手动添加依赖：
    打开你的 package.json 文件，找到 dependencies 部分。如果没有 dependencies 部分，可以手动创建一个。然后，添加你链接的包的名称和版本。例如，如果你链接的包名为 my-package，你可以这样添加：

    1
    2
    3
    4
    5
    {
      "dependencies": {
        "my-package": "file:../path/to/my-package"
      }
    }

    注意：file:../path/to/my-package 是一个相对路径，指向你本地包的目录。确保路径正确。

  2. 重新安装依赖：
    添加依赖后，运行以下命令重新安装依赖：

    1
    npm install

    这个命令会根据 package.json 文件中的依赖信息重新安装所有依赖包。

  3. 确认依赖安装成功：
    安装完成后，检查 node_modules 目录，确认 my-package 已经正确安装。你可以运行以下命令查看：

    1
    ls -l node_modules

  4. 测试链接的包：
    在你的项目中尝试导入和使用链接的包，看看是否能够成功加载和使用。例如，如果你链接了一个名为 my-package 的包，你可以在项目中这样使用：

    1
    2
    const myPackage = require('my-package');
    console.log(myPackage);

    如果能够成功加载并输出内容，说明链接成功。

通过这些步骤，你应该能够确保 package.json 文件中正确引入了链接的包，并且在项目中能够正常使用。如果问题仍然存在，可以考虑查看 npm 的日志文件或者在 npm 的 GitHub 仓库中查找相关问题。

3、启动项目并测试

image-20240622135130555