node基础-文件系统-文件写操作

wendu

　　文件操作频率最高的就是读跟写。nodejs的文件的读取API在《node基础-文件系统-读取文件》里已经简单介绍过，本文就简单介绍下nodejs的文件写API。
　　nodejs的文件操作均提供了同步、异步两种方式，写操作也是同样的，常用的两个接口为fs.writeFile（异步）、fs.writeFileSync(同步），下面就来看看他们的使用以及区别。

fs.writeFile(filename, data, [options], callback)
　　先来看下API说明



/**
* 往文件里异步写数据，写入的内容可以是字符串，也可以是二进制数据。
* 如果文件不存在，则创建；如果文件已存在，那么内容会被覆盖
* @param {String} filename 文件名
* @param {String|Buffer} data 要往文件里写的内容，可以是字符串，也可以是二进制数据。当为二进制数据时候，options.encoding 会被忽略
* @param {Object} [options]
* @param {String} options.encoding 编码，默认是utf8
* @param {Number} options.mode=438 模式
* @param {String} options.flag=w 写文件的模式
* @param {Function} callback 回调方法
*/
fs.writeFile(filename, data, [options], callback)
　　接下来我们来看看实际例子，首先，需要引入fs，下面为节省篇幅就不再贴这行代码了



var fs = require('fs');


例子一：往不存在的文件里写内容
　　往一个不存在的文件里写内容，则会先创建该文件，再往里面写内容



var noneExistFileName = ['async_create.', new Date()-0, '.txt'].join('');
fs.writeFile(noneExistFileName, '文件不存在，则创建', function(err){
if(err) throw err;
console.log(noneExistFileName+'不存在，被创建了！');
});


例子二：往存在的文件里写内容
　　如果该文件已存在，则原有文件内容会北覆盖



fs.writeFile('async_exists.txt', '文件已存在，则覆盖内容 -- '+(new Date()-0), function(err){
if(err) throw err;
console.log('exists.txt已存在，内容被覆盖！');
});


例子三：往已经存在的文件里追加内容
　　options.flag 设置为 'a' 时，则会将写模式变为追加内容



fs.writeFile('async_add.txt', '\n文件已存在，并追加内容 -- '+(new Date()-0), {
flag: 'a'
}, function(err){
if(err) throw err;
console.log('exists.txt已存在，内容被覆盖！');
});

fs.writeFileSync(filename, data, [options])
　　写文件的同步版本，同样先来看下API说明，你会发现跟fs.writeFile 没啥区别，就是少了个回调



/**
* 文件同步写接口，是fs.writeFile的同步版本，参数也差不多
* @param {String} filename 文件名
* @param {String|Buffer} data 要往文件里写的内容，可以是字符串，也可以是二进制数据。当为二进制数据时候，options.encoding 会被忽略
* @param {Object} [options]
* @param {String} options.encoding 编码，默认是utf8
* @param {Number} options.mode=438 模式
* @param {String} options.flag=w 写文件的模式
*/
fs.writeFileSync(filename, data, [options])
　　下面我们看下具体例子



例子一：往不存在的文件里写内容，则创建该文件



// case 1：往不存在的文件里写内容，则创建该文件
var noneExistFileName = ['sync_create.', new Date()-0, '.txt'].join('');
fs.writeFile(noneExistFileName, '文件不存在，则创建');


例子二：往存在的文件里写内容，原有内容被覆盖



fs.writeFile('sync_exists.txt', '文件已存在，则覆盖内容 -- '+(new Date()-0));


例子三：往已经存在的文件里追加内容



fs.writeFile('sync_add.txt', '\n文件已存在，并追加内容 -- '+(new Date()-0), {
flag: 'a'
});

完整示例
　　demo下载请点击，将代码随便解压缩到任意目录下，然后在该目录下运行命令 node writefile.js 即可



/**
* 文件写入demo，by 程序猿小卡
*/
var fs = require('fs');
/**
* 往文件里异步写数据，写入的内容可以是字符串，也可以是二进制数据。
* 如果文件不存在，则创建；如果文件已存在，那么内容会被覆盖
* @param {String} filename 文件名
* @param {String|Buffer} data 要往文件里写的内容，可以是字符串，也可以是二进制数据。当为二进制数据时候，options.encoding 会被忽略
* @param {Object} [options]
* @param {String} options.encoding 编码，默认是utf8
* @param {Number} options.mode=438 模式
* @param {String} options.flag=w 写文件的模式
* @param {Function} callback 回调方法
*/
// fs.writeFile(filename, data, [options], callback)
// case 1：往不存在的文件里写内容，则创建该文件
var noneExistFileName = ['async_create.', new Date()-0, '.txt'].join('');
fs.writeFile(noneExistFileName, '文件不存在，则创建', function(err){
if(err) throw err;
console.log(noneExistFileName+'不存在，被创建了！');
});
// case 2：往存在的文件里写内容，原有内容被覆盖
fs.writeFile('async_exists.txt', '文件已存在，则覆盖内容 -- '+(new Date()-0), function(err){
if(err) throw err;
console.log('exists.txt已存在，内容被覆盖！');
});
// case 3：往已经存在的文件里追加内容
fs.writeFile('async_add.txt', '\n文件已存在，并追加内容 -- '+(new Date()-0), {
flag: 'a'
}, function(err){
if(err) throw err;
console.log('exists.txt已存在，内容被覆盖！');
});
/**
* 文件同步写接口，是fs.writeFile的同步版本，参数也差不多
* @param {String} filename 文件名
* @param {String|Buffer} data 要往文件里写的内容，可以是字符串，也可以是二进制数据。当为二进制数据时候，options.encoding 会被忽略
* @param {Object} [options]
* @param {String} options.encoding 编码，默认是utf8
* @param {Number} options.mode=438 模式
* @param {String} options.flag=w 写文件的模式
*/
// fs.writeFileSync(filename, data, [options])
// case 1：往不存在的文件里写内容，则创建该文件
var noneExistFileName = ['sync_create.', new Date()-0, '.txt'].join('');
fs.writeFile(noneExistFileName, '文件不存在，则创建');
// case 2：往存在的文件里写内容，原有内容被覆盖
fs.writeFile('sync_exists.txt', '文件已存在，则覆盖内容 -- '+(new Date()-0));
// case 3：往已经存在的文件里追加内容
fs.writeFile('sync_add.txt', '\n文件已存在，并追加内容 -- '+(new Date()-0), {
flag: 'a'
});

写在后面
　　官方文档请点击
　　本文如有错漏，请指出 :)