nodejs fs如何删除文件

# Node.js fs如何删除文件

在Node.js中，文件系统操作主要通过内置的`fs`模块实现。删除文件是常见的文件操作之一，本文将详细介绍如何使用`fs`模块同步和异步删除文件，以及相关的注意事项。

## 1. 引入fs模块

首先需要引入Node.js内置的`fs`模块：

```javascript
const fs = require('fs');

2. 异步删除文件：fs.unlink()

fs.unlink()是删除文件的异步方法：

fs.unlink('file.txt', (err) => {
  if (err) {
    console.error('删除文件失败:', err);
    return;
  }
  console.log('文件删除成功');
});

参数说明：

• 第一个参数：文件路径
• 第二个参数：回调函数，接收一个错误参数

特点：

• 非阻塞I/O操作
• 适合大多数应用场景
• 需要通过回调函数处理结果

3. 同步删除文件：fs.unlinkSync()

如果需要同步删除文件，可以使用fs.unlinkSync()：

try {
  fs.unlinkSync('file.txt');
  console.log('文件删除成功');
} catch (err) {
  console.error('删除文件失败:', err);
}

特点：

• 阻塞式操作
• 适合脚本或需要确保操作顺序的场景
• 使用try-catch处理错误

4. Promise-based API（fs.promises）

Node.js 10+提供了Promise版本的API：

const fsPromises = require('fs').promises;

async function deleteFile() {
  try {
    await fsPromises.unlink('file.txt');
    console.log('文件删除成功');
  } catch (err) {
    console.error('删除文件失败:', err);
  }
}

deleteFile();

优势：

• 避免回调地狱
• 可以使用async/await语法
• 与现代JavaScript代码风格更契合

5. 删除前检查文件是否存在

建议在删除前检查文件是否存在：

if (fs.existsSync('file.txt')) {
  fs.unlinkSync('file.txt');
} else {
  console.log('文件不存在');
}

或者使用异步方式：

fs.access('file.txt', fs.constants.F_OK, (err) => {
  if (err) {
    console.log('文件不存在');
    return;
  }
  fs.unlink('file.txt', (err) => {
    // 处理删除结果
  });
});

6. 注意事项

1. 权限问题：确保进程对文件有写权限
2. 路径问题：使用绝对路径或正确处理相对路径
3. 文件锁定：被其他进程锁定的文件可能无法删除
4. 符号链接：unlink会删除链接本身而非目标文件
5. 错误处理：始终处理可能的错误

7. 完整示例

const fs = require('fs');
const path = require('path');

const filePath = path.join(__dirname, 'test.txt');

// 异步删除
function deleteFileAsync() {
  fs.unlink(filePath, (err) => {
    if (err && err.code === 'ENOENT') {
      console.log('文件不存在');
    } else if (err) {
      console.error('删除失败:', err);
    } else {
      console.log('异步删除成功');
    }
  });
}

// Promise方式
async function deleteFilePromise() {
  try {
    await fs.promises.unlink(filePath);
    console.log('Promise方式删除成功');
  } catch (err) {
    if (err.code === 'ENOENT') {
      console.log('文件不存在');
    } else {
      console.error('删除失败:', err);
    }
  }
}

deleteFileAsync();
deleteFilePromise();

总结

Node.js提供了多种删除文件的方式： - 异步回调：fs.unlink() - 同步方式：fs.unlinkSync() - Promise API：fs.promises.unlink() - 第三方库（如fs-extra）

根据应用场景选择合适的方法，并始终做好错误处理。对于现代Node.js应用，推荐使用Promise API配合async/await语法，可以使代码更清晰易读。 “`