【Node.js】NPM 和 package.json

NPM

npm 是 Node.js 的包管理工具，基于命令行，用于安装、升级、移除、管理依赖项。

常用命令：

1. npm init：初始化一个新的 npm 项目，创建 package.json 文件。（括号里为默认值）
   
   description：对于这个插件（或者包或者项目）的描述。
   entry point：项目或者包的入口文件。
   git repository：对应自己的 github 的仓库地址。
   keywords：该项目的关键字（搜索时候进行关键字匹配）。
   license：协议（常见的有 MIT 或者 Apache ）

2. npm install：安装一个包或一组包，并且会在当前目录存放一个node_modules 文件夹，和一个 package-lock.json 文件，并同时在 package.json 中生成对应的 dependencies。

3. npm install <package-name>：安装指定的包。（同时可以指定版本，例如npm i vue@2.6.0）

4. npm install <package-name> --save：安装指定的包，并将其添加到 package.json 文件中的依赖列表中。（现在版本不加 --save 也没有问题）

5. npm install <package-name> --save-dev：安装指定的包，并将其添加到 package.json 文件中的开发依赖列表中，比如 webpack，vite，rollup 生产环境不需要。（简写为-D）

6. npm install -g <package-name>：全局安装指定的包。

7. npm update <package-name>：更新指定的包。

8. npm uninstall <package-name>：卸载指定的包。

9. npm run <script-name>：执行 package.json 文件中定义的脚本命令。

10. npm search <keyword>：搜索 npm 库中包含指定关键字的包。

11. npm info <package-name>：查看指定包的详细信息。

12. npm info 包名 version ：获取最新版本

13. npm list：列出当前项目中安装的所有包。

14. npm outdated：列出当前项目中需要更新的包。

15. npm audit：检查当前项目中的依赖项是否存在安全漏洞。

16. npm publish：发布自己开发的包到 npm 库中。

17. npm login：登录到 npm 账户。

18. npm logout：注销当前 npm 账户。

19. npm link: 将本地模块链接到全局的 node_modules 目录下

20. npm config list 用于列出所有的 npm 配置信息。执行该命令可以查看当前系统和用户级别的所有 npm 配置信息，以及当前项目的配置信息（如果在项目目录下执行该命令）
    

21. npm get registry 用于获取当前 npm 配置中的 registry 配置项的值。registry 配置项用于指定 npm 包的下载地址，如果未指定，则默认使用 npm 官方的包注册表地址

22. npm set registry npm config set registry <registry-url> 命令，将 registry 配置项的值修改为指定的 <registry-url> 地址
    

    也可以通过 xmzs 包进行镜像管理。

Package json

执行 npm init 初始化一个 package.json。

1. name：项目名称，必须是唯一的字符串，通常采用小写字母和连字符的组合。

2. version：项目版本号，通常采用语义化版本号规范。

   1.0.0
   主版本号：重大更新或者改动；
   次版本号：功能的更新；
   修订号：修复 bug。

3. description：项目描述。

4. main：项目的主入口文件路径，通常是一个 JavaScript 文件。

5. type：

6. module：

7. browser：

8. keywords：项目的关键字列表，方便他人搜索和发现该项目。

9. author：项目作者的信息，包括姓名、邮箱、网址等。

10. license：项目的许可证类型，可以是自定义的许可证类型或者常见的开源许可证（如 MIT、Apache 等）。

11. dependencies：项目所依赖的包的列表，这些包会在项目运行时自动安装。
    

12. devDependencies：项目开发过程中所需要的包的列表，这些包不会随项目一起发布，而是只在开发时使用。

13. peerDependencies：项目的同级依赖，即项目所需要的模块被其他模块所依赖。（一般给编写插件人员或者编写npm包的开发人员去使用）（例如下图：vite-plugin 是基于 vite 使用的，而不能凭空运行）
    

14. scripts：定义了一些脚本命令，比如启动项目、运行测试等。（例如下图：输出 Error 字符串并断掉进程）
    

15. repository：项目代码仓库的信息，包括类型、网址等。

16. bugs：项目的 bug 报告地址。

17. homepage：项目的官方网站地址或者文档地址。

npm run dev 的执行过程

直接执行 vite 命令发现会报错。

在 mode_modules 中 vite 下的package.json 中会发现， vite 命令做了一个软连接，是从 bin/vite.js 执行的。

过程：先从本地的 node_modles 下寻找 bin/vite.js；找不到会从全局的 node 包下去找，最后会从环境变量中找。