- File System所有文件操作提供同步和异步的两种方式，本笔记只记录异步的API异步方式其最后一个参数是回调函数。回调函数的第一个参数往往是错误对象，如果没有发生参数，那么第一个参数可能是null或者undefinded。同步函数可以使用try catch 捕获异常多个异步函数在同一层次执行，是无法保证顺序的。最好将一个函数放在另一个函数的回调函数中去执行。这种回调的嵌套层次一旦过深，就会造成回调地狱一般情况下，非常不建议使用同步的fs方法，因为同步的方法会阻断其他事情，直到fs方法完成。1.1. 文件路径filepaths目前支持4中stringBufferURL Object以file:开头的协议string 路径会被解释为utf-8格式，可以使用相对路径和绝对路径，相对路径是当前工作路径，可以从process.cwd()获取当前工作路径。1.2. 文件描述符操作系统会限制文件描述符的数量忘记关闭文件可能导致内存泄露或者程序崩溃任何文件描述符都支持写操作如果文件描述符的类型是文件，那么它不会自动关闭写操作会从文件的开头，而不会覆盖之后的内容。举例：文件内容是Hello World, 如果在写入’Aloha’，那么文件的内容是Aloha World ,而不是’Aloha’.1.3. 线程池使用fs所有的api，除了那些同步的api和fs.FSWatcher(), 基本上都使用libuv的线程池。在有些应用程序上，这个可能导致非常糟糕的性能表现。libuv的线程池有固定的大小，默认只有4个，可以通过设置环境变量UV_THREADPOOL_SIZE去增加libuv的线程的数量。1.4. Class: fs.Dirent 判断文件类型当fs.readdir()或者fs.readdirSync()被调用，并且参数withFileTypes是true, 那么返回结果就是fs.Dirent objects, 而不是strings or Buffersdirent方法dirent.isBlockDevice()dirent.isCharacterDevice()dirent.isDirectory()dirent.isFIFO()dirent.isFile()dirent.isSocket()dirent.isSymbolicLink()dirent.name1.5. Class: fs.FSWatcher 文件变动监控来自 fs.watch()Eventchangecloseerrorwatcher.close()注意：某些系统可能不会返回filename。如果encoding参数是buffer，那么文件名是以buffer的形式返回，默认文件名是utf-8格式的字符串。fs.watch(’./tmp’, { encoding: ‘buffer’ }, (eventType, filename) => { if (filename) { console.log(filename); // Prints: <Buffer …> }});1.6. Class: fs.ReadStream 可读流来自fs.createReadStream()Eventcloseopenready 第一次触发是在open事件之后readStream.bytesReadreadStream.pathreadStream.pending1.7. Class: fs.Stats 获取文件信息来自 fs.stat(), fs.lstat() and fs.fstat() 以及他们的同步版本。stats.isBlockDevice()stats.isCharacterDevice()stats.isDirectory()stats.isFIFO()stats.isFile()stats.isSocket()stats.isSymbolicLink()Stats { dev: 2114, ino: 48064969, mode: 33188, nlink: 1, uid: 85, gid: 100, rdev: 0, size: 527, blksize: 4096, blocks: 8, atimeMs: 1318289051000.1, mtimeMs: 1318289051000.1, ctimeMs: 1318289051000.1, birthtimeMs: 1318289051000.1, atime: Mon, 10 Oct 2011 23:24:11 GMT, mtime: Mon, 10 Oct 2011 23:24:11 GMT, ctime: Mon, 10 Oct 2011 23:24:11 GMT, birthtime: Mon, 10 Oct 2011 23:24:11 GMT }1.8. Class: fs.WriteStream 可写流EventcloseopenreadywriteStream.bytesWrittenwriteStream.pathwriteStream.pending2. 常用方法测试访问权限测试 fs.access(path[, mode], callback) 测试是否可以访问某个路径。不建议fs.open(), fs.readFile() or fs.writeFile()调用前，调用fs.access去检查测试路径是否存在 fs.exists(path, callback)， 不建议fs.open(), fs.readFile() or fs.writeFile()调用前，调用fs.exists去检测文件是否存在流操作创建可读流 fs.createReadStream(path[, options])创建可写流 fs.createWriteStream(path[, options])文件夹操作创建文件夹 fs.mkdir(path[, options], callback)删除目录 fs.rmdir(path, callback)创建临时文件夹 fs.mkdtemp(prefix[, options], callback)读取文件夹 fs.readdir(path[, options], callback)文件操作打开文件 fs.open(path[, flags[, mode]], callback)读取文件 fs.read(fd, buffer, offset, length, position, callback)读取文件 fs.readFile(path[, options], callback)重命名文件 fs.rename(oldPath, newPath, callback)读取文件信息 fs.stat(path[, options], callback)删除文件 fs.unlink(path, callback)停止监控文件 fs.unwatchFile(filename[, listener])修改时间 fs.utimes(path, atime, mtime, callback)监控文件变化 fs.watch(filename, options)关闭文件 fs.close(fd, callback)追加文件 fs.appendFile(path, data[, options], callback)改变文件模式 fs.chmod(path, mode, callback)改变文件所属 fs.chown(path, uid, gid, callback)复制文件 fs.copyFile(fs.copyFile(src, dest[, flags], callback))写文件 fs.write(fd, buffer[, offset[, length[, position]]], callback)写文件 fs.write(fd, string[, position[, encoding]], callback)写文件 fs.writeFile(file, data[, options], callback)其他fs常量 fs.constants注意事项fs.watch并不是百分百跨平台。例如它的recursive参数仅支持macOS和windows。fs.watch的底层通知机制在不同平台上的实现是不同的，如果底层不支持某个特性，那么fs.watch也是不能支持的。另外回调函数中的filename参数，也是不保证一定存在。fs.watch()比fs.watchFile()更高效，可能的话，尽量使用前者。3. 参考Node.js fs