NPM 使用教程

NPM 使用教程

1. 什么是 NPM?

NPM(Node Package Manager)是 JavaScript 世界中最流行的包管理器和软件仓库。它不仅允许开发者轻松地下载和管理依赖库,还支持发布自己的包,方便在项目中复用代码。无论是构建小型应用程序还是大型项目,NPM 都是一个不可或缺的工具。

2. NPM 的安装

在开始使用 NPM 之前,你需要确保已经安装了 Node.js。Node.js 自带 NPM,因此安装 Node.js 后会自动安装 NPM。

  • 安装 Node.js:

    你可以从 Node.js 官网 下载最新的 Node.js 安装包并进行安装。安装完成后,可以在终端中输入以下命令查看 NPM 是否已正确安装:

    bash 复制代码
    node -v  # 检查 Node.js 版本
    npm -v   # 检查 NPM 版本
3. 初始化一个项目

在使用 NPM 管理项目依赖之前,首先需要初始化一个项目。这会在你的项目目录中生成一个 package.json 文件,记录项目的基本信息和依赖库。

  • 初始化项目:

    在你的项目根目录下运行以下命令:

    bash 复制代码
    npm init

    NPM 会提示你输入一些项目的基本信息,如项目名称、版本、描述等。你可以根据需求填写,也可以直接按回车跳过,使用默认值。最后会生成一个类似这样的 package.json 文件:

    json 复制代码
    {
      "name": "my-project",
      "version": "1.0.0",
      "description": "A sample project",
      "main": "index.js",
      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
      },
      "author": "Your Name",
      "license": "ISC"
    }
    • 快速初始化:

      如果不想每次都手动输入项目信息,可以使用 -y 参数快速初始化,NPM 会使用默认值创建 package.json 文件。

      bash 复制代码
      npm init -y
4. 安装依赖包

NPM 最常用的功能之一就是安装依赖包。你可以从 NPM 官方仓库中下载任何公开发布的包,并将其添加到项目中。

  • 安装依赖包:

    使用以下命令可以安装某个依赖包,例如安装 express

    bash 复制代码
    npm install express

    这会在 node_modules 目录中下载并安装 express 包,并自动在 package.json 文件中的 dependencies 字段中添加对应的版本信息:

    json 复制代码
    "dependencies": {
      "express": "^4.17.1"
    }
  • 安装开发依赖包:

    如果某个包只在开发环境中使用(例如测试库),可以使用 --save-dev-D 参数将其作为开发依赖添加:

    bash 复制代码
    npm install mocha --save-dev

    package.json 文件中的 devDependencies 字段会记录这些开发依赖:

    json 复制代码
    "devDependencies": {
      "mocha": "^8.2.1"
    }
5. 卸载依赖包

有时你可能需要卸载某个依赖包。可以使用以下命令:

bash 复制代码
npm uninstall package-name

例如,要卸载 express

bash 复制代码
npm uninstall express

这会从 node_modules 目录中删除 express,并从 package.jsondependencies 字段中移除对应的记录。

6. 全局安装包

有些工具或命令行工具需要全局安装。全局安装的包可以在系统的任何地方使用。

  • 全局安装:

    使用 -g 参数可以将包全局安装,例如安装 npm 自带的 http-server 工具:

    bash 复制代码
    npm install -g http-server
  • 查看全局安装的包:

    可以使用以下命令查看所有全局安装的包:

    bash 复制代码
    npm list -g --depth=0

    --depth=0 参数限制只显示顶级包,而不会列出每个包的依赖。

7. 使用 NPM 脚本

NPM 允许你在 package.json 中定义脚本,以简化常用命令的执行。比如你可以将启动服务器的命令、编译代码的命令等放在脚本中。

  • 定义脚本:

    例如,添加一个启动脚本:

    json 复制代码
    "scripts": {
      "start": "node index.js",
      "test": "mocha"
    }
  • 运行脚本:

    运行脚本只需使用 npm run 命令。例如,要运行 start 脚本:

    bash 复制代码
    npm run start

    对于 starttest 这两个脚本,可以直接运行 npm startnpm test,无需使用 run 关键字。

8. 发布自己的包

如果你开发了一个通用的功能模块,可以将其打包并发布到 NPM 上,供他人使用。

  • 登录 NPM 账户:

    首先需要登录 NPM 账户,如果没有账户,可以使用 npm adduser 注册:

    bash 复制代码
    npm login
  • 发布包:

    确保 package.json 中的 nameversion 是唯一的,然后运行以下命令发布你的包:

    bash 复制代码
    npm publish
  • 更新包:

    每次更新包时,需要增加 version 号,否则 NPM 会拒绝发布。更新 version 后再次运行 npm publish 即可。

9. 总结

NPM 是管理 JavaScript 项目的强大工具,它简化了依赖管理、项目初始化、脚本运行和包发布等流程。通过掌握 NPM 的基本用法,你可以更高效地管理和开发项目。

希望这篇教程能帮助你更好地理解和使用 NPM。如果你有任何问题或想法,欢迎在评论区分享!

相关推荐
前端工作日常16 小时前
我学习到的npx内部实现机制
npm
minglie12 天前
npm ali-oss库依赖冲突
前端·npm
屑曦晨3 天前
npm 全局包迁移指南:从系统目录到用户目录
npm·node.js
勉灬之8 天前
利用双网卡服务器搭建 Verdaccio 中转,解决内网 npm 依赖下载问题
运维·服务器·npm
Flynt16 天前
npm v12 来了:allowScripts 默认关闭,我的项目差点跑不起来
安全·npm·node.js
JuliusDeng18 天前
一文搞懂 `.npmrc`:npm 源、SSL 与 `_authToken` 配置避坑
npm·前端工程化
kyriewen22 天前
2026 年了,这 6 个 npm 包可以卸载了——浏览器原生 API 已经能替代
前端·javascript·npm
l1o3v1e4ding1 个月前
windows安装Claude Code,并接入Deepseek-v4模型 ,提供离线安装包
git·npm·node.js·claude code·cc-switchcc
TT_Close1 个月前
别再复制旧 Flutter 工程了,真正拖慢你的不是业务代码
flutter·npm·visual studio code
Penfy_Z1 个月前
【Python LLM 调用踩坑】Connection error 终极解决方案!npm 代理导致阿里云通义千问接口连接失败
开发语言·python·npm