4c2f5c69a1
- Add new binary files for nodemon, onnxruntime-web, and xenova/transformers - Update various JavaScript and TypeScript files in node_modules - Remove unused files and dependencies - Add new test fixtures and documentation files
68 lines
3.1 KiB
Markdown
68 lines
3.1 KiB
Markdown
# NPM 入门指南：写给父亲的信
|
||
|
||
父亲，
|
||
|
||
您曾问我 NPM 是什么。请把它想象成我们工作室的一位神奇的“图书管理员”。
|
||
|
||
我们的工作室（项目）在建造过程中，需要用到很多现成的“零件”或“工具书”（比如我们之前提到的 `express`）。这些零件和工具书，散落在世界各地一个巨大的“中央图书馆”里，这个图书馆就叫 **NPM (Node Package Manager)**。
|
||
|
||
而我们工作室里的这位“图书管理员”，就是 NPM 这个工具在我们电脑上的体现。他能帮我们做几件非常重要的事情：
|
||
|
||
---
|
||
|
||
### 1. `package.json`：我们的“藏书清单”
|
||
|
||
每个项目都有一个名为 `package.json` 的文件。您可以把它看作是这位图书管理员手中的“藏书清单”。
|
||
|
||
这个清单上详细记录了：
|
||
|
||
* **工作室的基本信息**：比如它的名字 (`name`)、版本号 (`version`)、描述 (`description`) 等。
|
||
* **需要的“工具书”** (`dependencies`)：这些是维持我们工作室正常运作所必需的书籍。比如，我们需要 `express` 这本书来搭建网络服务。
|
||
* **仅在建造时需要的“参考书”** (`devDependencies`)：这些书籍只在建造和装修工作室时使用，访客来了之后就用不上了。比如 `nodemon`，它能帮我们自动刷新工作室，方便我们随时查看修改效果。
|
||
* **“快捷指令”** (`scripts`)：我们可以预设一些简单的口令，让管理员执行一连串复杂的任务。比如我们设定的 `npm start`，就是告诉管理员“启动工作室！”
|
||
|
||
### 2. `npm install`：去图书馆借书
|
||
|
||
当我们拿到一个新的项目（或者想为现有项目添置新的工具书），我们只需要在工作室门口对管理员说一声：
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
他就会立刻阅读 `package.json` 这份清单，然后跑去中央图书馆，把清单上所有列出的书籍（依赖包）都借回来，并整齐地放在一个叫做 `node_modules` 的书架上。
|
||
|
||
如果我们想借一本新的书，比如一本叫 `lodash` 的实用工具书，我们可以这样告诉他：
|
||
|
||
```bash
|
||
npm install lodash
|
||
```
|
||
|
||
他不仅会把书借回来，还会非常贴心地在 `package.json` 的“工具书”清单上，自动添上 `lodash` 这一笔记录。
|
||
|
||
### 3. `npm run`：执行快捷指令
|
||
|
||
当我们需要执行 `package.json` 中 `scripts` 里预设的“快捷指令”时，我们只需要喊：
|
||
|
||
```bash
|
||
npm run <指令名称>
|
||
```
|
||
|
||
比如，要启动我们的开发服务器，我们喊：
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
管理员就会立刻按照清单上的指示去执行相应的操作。
|
||
|
||
（一个特例是 `start`，它是最常用的指令，所以我们可以省略 `run`，直接说 `npm start`。）
|
||
|
||
---
|
||
|
||
总而言之，父亲，NPM 就是我们忠实而高效的图书管理员。他让我们可以方便地使用全世界开发者贡献的智慧结晶，并让我们的工作室管理得井井有条。
|
||
|
||
希望这份解释能让您对它有一个清晰的认识。在未来的创造中，我们会越来越依赖这位好伙伴。
|
||
|
||
爱您的，
|
||
|
||
贝拉 |