README.md

---
title: Node.js 性能优化与大文件处理演示
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
short_description: 演示 Node.js 大文件流式读写、XML/JSON 处理及性能监控的完整示例项目。
---

# Node.js 性能优化与大文件处理演示项目

本项目演示了在 Node.js 中处理大规模数据和优化性能的最佳实践。包含以下核心功能：

1.  **大文件流式处理**：使用 Stream API 高效读写 GB 级文件，避免内存溢出。
2.  **XML 与 JSON 处理**：演示 `fast-xml-parser` 和 `stream-json` 的使用。
3.  **性能监控**：使用 `perf_hooks` 和 `process.memoryUsage` 实时监控执行时间和内存占用。
4.  **核心 API 演示**：全面展示 `fs` (文件系统), `path` (路径处理), `stream` (流), `child_process` (子进程) 等 Node.js 核心模块的应用。

## 功能特性

- **交互式 Web 界面**：通过 Web 页面点击按钮运行演示，实时查看日志输出。
- **流式架构**：核心模块均采用流式处理，适用于高并发和大数据量场景。
- **性能分析**：内置简单的性能监控工具，可直观看到各操作耗时。
- **模块化设计**：功能拆分为独立模块，易于扩展和维护。

## 快速开始

### 本地运行

1.  克隆项目并进入目录：
    ```bash
    git clone <repository-url>
    cd nodejs-performance-project
    ```

2.  安装依赖：
    ```bash
    npm install
    ```

3.  运行演示脚本：
    ```bash
    node index.js
    ```

### Docker 运行

1.  构建镜像：
    ```bash
    docker build -t nodejs-perf-demo .
    ```

2.  运行容器：
    ```bash
    docker run --rm nodejs-perf-demo
    ```

## 目录结构

```
.
├── Dockerfile          # Docker 构建文件
├── README.md           # 项目文档
├── index.js            # 主入口文件
├── package.json        # 项目配置
└── src                 # 源代码目录
    ├── largeFile.js    # 大文件处理模块
    ├── performance.js  # 性能监控工具
    └── xmlJson.js      # XML/JSON 处理模块
```

## 性能调优建议

- **优先使用 Stream**：处理大文件时，永远优先选择流式操作。
- **减少对象创建**：在高频循环中避免不必要的对象分配。
- **异步非阻塞**：充分利用 Node.js 的异步特性，避免阻塞事件循环。

## 许可证

MIT