在当代 Node.js 开发中，fsPromises API 比传统的 fs 模块越来越受到青睐。这种偏好源于其与现代 JavaScript 功能的卓越集成，特别是 async/await，这增强了代码的可读性和可维护性，尤其是在复杂的场景中。

为什么 fsPromises 是首选

1. 异步/等待兼容性

fsPromises 与 async/await 无缝集成，允许以更同步、直观的方式构建异步代码。

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

async function readAndProcessFile() {
    try {
        const data = await fs.readFile('input.txt', 'utf8');
        const processedData = data.toUpperCase();
        await fs.writeFile('output.txt', processedData);
        console.log('File processed successfully');
    } catch (err) {
        console.error('Error processing file:', err);
    }
}

readAndProcessFile();

2. 简化的错误处理

借助 async/await 和 fsPromises，使用 try/catch 块、镜像同步代码结构，错误处理变得更加简单。

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

async function copyFile(source, destination) {
    try {
        await fs.copyFile(source, destination);
        console.log(`${source} was copied to ${destination}`);
    } catch (err) {
        console.error('Error copying file:', err);
    }
}

copyFile('source.txt', 'destination.txt');

3. 避免回调地狱

传统的 fs 方法依赖于回调，这在处理多个异步操作时可能会导致深度嵌套、难以阅读的代码。 fsPromises 通过返回 Promises 解决了这个问题，Promises 可以通过 async/await 链接或管理。

// Traditional fs (callback hell)
fs.readdir('directory', (err, files) => {
    if (err) throw err;
    files.forEach((file) => {
        fs.readFile(`directory/${file}`, 'utf8', (err, content) => {
            if (err) throw err;
            fs.writeFile(`processed/${file}`, content.toUpperCase(), (err) => {
                if (err) throw err;
                console.log(`Processed ${file}`);
            });
        });
    });
});

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

async function processDirectory() {
    try {
        const files = await fs.readdir('directory');
        for (const file of files) {
            const content = await fs.readFile(`directory/${file}`, 'utf8');
            await fs.writeFile(`processed/${file}`, content.toUpperCase());
            console.log(`Processed ${file}`);
        }
    } catch (err) {
        console.error('Error processing directory:', err);
    }
}

processDirectory();

4. 提高代码一致性

利用 fsPromises 可以提高代码库的一致性，特别是在广泛使用 Promise 或 async/await 进行其他异步操作的项目中。

5. 部分场景性能更佳

虽然性能差异通常可以忽略不计，但 fsPromises 可以在涉及多个异步操作的场景中提高代码执行效率，因为它避免了管理大量回调的开销。

fs 什么时候仍然相关？

尽管 fsPromises 具有优势，但在某些情况下传统 fs 模块仍然适用：

1. 遗留代码库：尚未更新的旧项目可能仍然依赖基于回调的 fs 方法。

2. 简单脚本：对于不需要额外抽象承诺的快速一次性脚本，fs 可能更简单。

3. 具体流操作：一些高级流操作仍然主要通过传统的fs模块支持。

4. 性能关键的低级操作：在需要绝对最小开销的极少数情况下，传统的 fs 方法可能是首选。

5. 与旧版 Node.js 版本的兼容性：如果需要支持旧版 Node.js 版本，传统的 fs 模块可确保更广泛的兼容性。

最佳实践

1. 一致的 API 用法：为项目选择 fsPromises 或 fs 并始终坚持使用它以保持代码一致性。

2. 错误处理：无论您使用哪个 API，始终实施正确的错误处理。

3. 异步操作：优先使用异步方法而不是同步方法，以避免阻塞事件循环，特别是在服务器环境中。

4. Promisification：如果需要使用传统的 fs 模块，可以考虑使用 util.promisify() 将基于回调的方法转换为基于 Promise 的方法。
   

const fs = require('fs');
const util = require('util');
const readFile = util.promisify(fs.readFile);

async function readFileContent() {
    try {
        const content = await readFile('example.txt', 'utf8');
        console.log(content);
    } catch (err) {
        console.error('Error reading file:', err);
    }
}

结论

对于大多数现代 Node.js 应用程序，fsPromises 是推荐的选择，因为它与 async/await 兼容、提高了可读性并且更容易处理错误。然而，传统的 fs 模块仍然占有一席之地，特别是在遗留系统、简单脚本或需要低级控制的特定用例中。当开始一个新项目或重构现有项目时，请考虑采用 fsPromises 在文件系统操作中充分利用现代 JavaScript 功能的强大功能。