Node.js核心模块及Api详解

以下是 Node.js 最常用的核心模块及 API 详解，按利用频率和紧张性分类整理：

---

一、高频核心模块

1. fs 文件系统

1. const fs = require('fs');
2. const fsPromises = require('fs').promises; // Promise 版本
4. // 异步读取文件（推荐）
5. fs.readFile('file.txt', 'utf8', (err, data) => {
6.   if (err) throw err;
7.   console.log(data);
8. });
10. // Promise 方式读取（ES6+）
11. fsPromises.readFile('file.txt', 'utf8')
12.   .then(data => console.log(data))
13.   .catch(console.error);
15. // 同步读取（慎用）
16. const data = fs.readFileSync('file.txt', 'utf8');
18. // 写文件
19. fs.writeFile('new.txt', 'Hello World', err => {
20.   if (err) throw err;
21. });
23. // 目录操作
24. fs.readdir('./', (err, files) => {
25.   console.log(files); // 获取目录文件列表
26. });
28. // 文件状态
29. fs.stat('file.txt', (err, stats) => {
30.   console.log(stats.isFile()); // 是否文件
31.   console.log(stats.size); // 文件大小
32. });

复制代码

2. path 路径处置惩罚

1. const path = require('path');
3. // 拼接路径（跨平台）
4. const fullPath = path.join(__dirname, 'subdir', 'file.txt');
6. // 解析绝对路径
7. path.resolve('src', 'app.js'); // 等同于 __dirname + '/src/app.js'
9. // 获取文件名/扩展名
10. path.basename('/foo/bar/baz.txt'); // 'baz.txt'
11. path.extname('index.html'); // '.html'
13. // 路径解析
14. path.parse('/home/user/file.txt');
15. /* 返回:
16. {
17.   root: '/',
18.   dir: '/home/user',
19.   base: 'file.txt',
20.   ext: '.txt',
21.   name: 'file'
22. } */

复制代码

3. http 网络服务

1. const http = require('http');
3. // 创建服务器
4. const server = http.createServer((req, res) => {
5.   res.writeHead(200, { 'Content-Type': 'text/plain' });
6.   res.end('Hello World');
7. });
9. server.listen(3000, () => {
10.   console.log('Server running on port 3000');
11. });
13. // 发起 HTTP 请求
14. http.get('http://api.example.com', (response) => {
15.   let data = '';
16.   response.on('data', chunk => data += chunk);
17.   response.on('end', () => console.log(data));
18. });

复制代码

---

二、中高频工具模块

1. events 事件触发器

1. const EventEmitter = require('events');
2. class MyEmitter extends EventEmitter {}
4. const myEmitter = new MyEmitter();
6. // 监听事件
7. myEmitter.on('event', (arg) => {
8.   console.log('Event triggered:', arg);
9. });
11. // 触发事件（可传参）
12. myEmitter.emit('event', { data: 123 });
14. // 一次性监听
15. myEmitter.once('single', () => console.log('Only once'));

复制代码

2. stream 流处置惩罚

1. const fs = require('fs');
3. // 读取流
4. const readStream = fs.createReadStream('bigfile.txt', 'utf8');
6. readStream.on('data', chunk => {
7.   console.log('Received chunk:', chunk.length);
8. });
10. readStream.on('end', () => {
11.   console.log('File read complete');
12. });
14. // 写入流
15. const writeStream = fs.createWriteStream('output.txt');
16. writeStream.write('Line 1\n');
17. writeStream.end('Final line');

复制代码

3. util 实用工具

1. const util = require('util');
3. // 回调转 Promise
4. const readFileAsync = util.promisify(fs.readFile);
6. // 继承检查
7. util.types.isDate(new Date()); // true
9. // 深度对象调试
10. console.log(util.inspect(obj, { depth: null }));

复制代码

---

三、常用全局对象

1. process 历程控制

1. // 环境变量
2. console.log(process.env.NODE_ENV);
4. // 命令行参数
5. process.argv.forEach((val, index) => {
6.   console.log(`${index}: ${val}`);
7. });
9. // 退出程序
10. process.exit(1); // 非零表示异常退出
12. // 标准输入输出
13. process.stdin.on('data', data => {
14.   process.stdout.write(`You typed: ${data}`);
15. });

复制代码

2. Buffer 二进制处置惩罚

1. // 创建 Buffer
2. const buf1 = Buffer.from('Hello');
3. const buf2 = Buffer.alloc(10); // 10字节空Buffer
5. // 写入数据
6. buf2.write('World');
8. // 转换格式
9. console.log(buf1.toString('base64')); // SGVsbG8=
10. console.log(Buffer.from('SGVsbG8=', 'base64').toString()); // Hello

复制代码

---

四、其他关键 API

1. 定时器

1. // setTimeout (单次)
2. const timer = setTimeout(() => {
3.   console.log('Delayed 1s');
4. }, 1000);
6. // clearTimeout(timer); // 取消
8. // setInterval (循环)
9. const interval = setInterval(() => {
10.   console.log('Every 2s');
11. }, 2000);
13. // clearInterval(interval);

复制代码

2. child_process 子历程

1. const { exec, spawn } = require('child_process');
3. // 执行 shell 命令
4. exec('ls -l', (err, stdout, stderr) => {
5.   console.log(stdout);
6. });
8. // 流式处理
9. const ls = spawn('ls', ['-lh', '/usr']);
10. ls.stdout.on('data', data => {
11.   console.log(`stdout: ${data}`);
12. });

复制代码

---

五、最佳实践要点

• 异步优先：始终优先利用异步 API（回调/Promise/async-await），制止阻塞事件循环
  
• 错误处置惩罚：全部回调函数必须检查 err 参数
  1. fs.readFile('file.txt', (err, data) => {
  2.   if (err) {
  3.     console.error('Read failed:', err.message);
  4.     return;
  5.   }
  6.   // 正常处理
  7. });

  复制代码
• 路径安全：利用 path.join() 替换字符串拼接，制止跨平台问题
  
• 流式处置惩罚：大文件操纵必须利用 Stream，防止内存溢出
  
• 环境区分：通过 process.env.NODE_ENV 区分开发/生产环境
  

---

六、常用第三方模块推荐

模块名用途安装命令expressWeb 框架npm install expressaxiosHTTP 客户端npm install axioslodash实用工具库npm install lodashmoment日期处置惩罚npm install momentwinston日记纪录npm install winstondotenv环境变量加载npm install dotenv 把握这些核心 API 后，可快速应对 90% 的 Node.js 开发场景。发起结合官方文档深入理解：https://nodejs.org/api/

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。