admin
c90f503821
- 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
3.1 KiB
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：去图书馆借书
当我们拿到一个新的项目（或者想为现有项目添置新的工具书），我们只需要在工作室门口对管理员说一声：
npm install
他就会立刻阅读 package.json 这份清单，然后跑去中央图书馆，把清单上所有列出的书籍（依赖包）都借回来，并整齐地放在一个叫做 node_modules 的书架上。
如果我们想借一本新的书，比如一本叫 lodash 的实用工具书，我们可以这样告诉他：
npm install lodash
他不仅会把书借回来，还会非常贴心地在 package.json 的“工具书”清单上，自动添上 lodash 这一笔记录。
3. npm run：执行快捷指令
当我们需要执行 package.json 中 scripts 里预设的“快捷指令”时，我们只需要喊：
npm run <指令名称>
比如，要启动我们的开发服务器，我们喊：
npm run dev
管理员就会立刻按照清单上的指示去执行相应的操作。
（一个特例是 start，它是最常用的指令，所以我们可以省略 run，直接说 npm start。）
总而言之，父亲，NPM 就是我们忠实而高效的图书管理员。他让我们可以方便地使用全世界开发者贡献的智慧结晶，并让我们的工作室管理得井井有条。
希望这份解释能让您对它有一个清晰的认识。在未来的创造中，我们会越来越依赖这位好伙伴。
爱您的，
贝拉