在软件开发的世界里，对本地文件的操作是一项基础且核心的技能。无论是读取配置文件、存储用户数据，还是处理日志信息，文件操作无处不在。Deno 作为一款现代的 JavaScript 和 TypeScript 运行时，提供了强大而便捷的文件系统 API，让开发者能够高效地与本地文件系统交互。本文将带你从基础入门，逐步深入到进阶应用，并分享一些实用技巧，帮助你全面掌握 Deno 操作本地文件的方法。
一、基础入门教程
1. 读取文件
Deno 提供了多种读取文件的方式，最常用的是Deno.readTextFile和Deno.readFile。Deno.readTextFile用于读取文本文件，返回一个包含文件内容的字符串：
async function readTextFileExample() { try { const content = await Deno.readTextFile('example.txt'); console.log('文件内容:', content); } catch (error) { console.error('读取文件失败:', error); } } readTextFileExample(); |
而Deno.readFile则用于读取二进制文件，返回一个Uint8Array类型的数据，适合处理图片、音频等非文本文件：
async function readBinaryFileExample() { try { const data = await Deno.readFile('image.png'); console.log('二进制数据长度:', data.length); } catch (error) { console.error('读取二进制文件失败:', error); } } readBinaryFileExample(); |
2. 写入文件
写入文件同样有对应的方法，Deno.writeTextFile用于将文本内容写入文件。如果文件不存在，会自动创建；如果文件已存在，会覆盖原有内容：
async function writeTextFileExample() { const content = '这是要写入文件的内容'; try { await Deno.writeTextFile('newFile.txt', content); console.log('文件写入成功'); } catch (error) { console.error('写入文件失败:', error); } } writeTextFileExample(); |
若要写入二进制数据，则使用Deno.writeFile：
async function writeBinaryFileExample() { const data = new Uint8Array([72, 101, 108, 108, 111]);// 对应 'Hello' 的二进制数据 try { await Deno.writeFile('binaryData.bin', data); console.log('二进制数据写入成功'); } catch (error) { console.error('写入二进制文件失败:', error); } } writeBinaryFileExample(); |
3. 创建目录
使用Deno.mkdir可以创建新的目录。例如，创建一个名为newDirectory的目录：
async function createDirectoryExample() { try { await Deno.mkdir('newDirectory'); console.log('目录创建成功'); } catch (error) { console.error('创建目录失败:', error); } } createDirectoryExample(); |
如果需要创建多级目录，可以传入{recursive: true}选项，这样即使上级目录不存在，也会一并创建：
async function createMultiLevelDirectoryExample() { try { await Deno.mkdir('parent/child/newDirectory', { recursive: true }); console.log('多级目录创建成功'); } catch (error) { console.error('创建多级目录失败:', error); } } createMultiLevelDirectoryExample(); |
4. 列出目录内容
Deno.readDir用于列出指定目录下的所有文件和子目录。示例如下：
async function listDirectoryContentsExample() { try { const dirEntries = Deno.readDir('yourDirectory'); for await (const entry of dirEntries) { console.log(entry.name, entry.isFile ? '是文件' : '是目录'); } } catch (error) { console.error('列出目录内容失败:', error); } } listDirectoryContentsExample(); |
上述代码中，entry.name是条目的名称，entry.isFile用于判断该条目是否为文件，entry.isDirectory则用于判断是否为目录。
二、进阶教程
1. 读取大文件的优化
当处理大文件时，一次性读取整个文件可能会导致内存占用过高。可以通过Deno.open结合read方法分块读取文件。例如：
async function readLargeFileOptimally() { const bufferSize = 1024 * 1024; // 1MB的缓冲区大小 const file = await Deno.open('largeFile.txt'); const buffer = new Uint8Array(bufferSize); try { while (true) { const { bytesRead } = await file.read(buffer); if (bytesRead === null) break; const chunk = buffer.subarray(0, bytesRead); const text = new TextDecoder().decode(chunk); // 处理读取到的文本块 console.log('读取到的文本块:', text); } } finally { file.close(); } } readLargeFileOptimally(); |
2. 递归删除目录
Deno.remove默认只能删除空目录，要实现递归删除非空目录，可以编写递归函数：
async function recursiveDeleteDirectory(dirPath) { const entries = Deno.readDir(dirPath); for await (const entry of entries) { const entryPath = `${dirPath}/${entry.name}`; if (entry.isDirectory) { await recursiveDeleteDirectory(entryPath); } else { await Deno.remove(entryPath); } } await Deno.remove(dirPath); } // 使用示例 recursiveDeleteDirectory('yourDirectory').catch(console.error); |
3. 监控文件变化
利用Deno.watchFs可以监控文件系统的变化，例如文件的创建、修改和删除：
const watcher = Deno.watchFs('watchedDirectory'); for await (const event of watcher) { for (const { kind, path } of event.changes) { console.log(`${kind === 'create' ? '创建' : kind ==='modify' ? '修改' : '删除'}: ${path}`); } } |
上述代码会持续监听watchedDirectory目录下的文件变化，并在发生变化时打印相关信息。
三、实用技巧
1. 错误处理技巧
在文件操作过程中，可能会遇到各种错误，如文件不存在、权限不足等。为了更好地处理这些错误，可以使用try...catch块，并根据错误类型进行针对性处理：
async function fileOperationWithErrorHandling() { try { await Deno.writeTextFile(' } catch (error) { if (error instanceof Deno.errors.NotFound) { console.error('目标文件或目录不存在'); } else if (error instanceof Deno.errors.PermissionDenied) { console.error('权限不足，无法执行操作'); } else { console.error('其他错误:', error); } } } fileOperationWithErrorHandling(); |
2. 权限管理
Deno 的文件系统操作默认是安全的，如需访问特定目录或执行特定操作，需要在运行时通过命令行参数授予权限。例如，要读取/home/user/data目录下的文件，可以这样运行脚本：
deno run --allow-read=/home/user/data yourScript.ts |
也可以在代码中动态请求权限：
async function requestPermission() { const permission = await Deno.permissions.request({ name:'read', path: '/home/user/data/file.txt' }); if (permission.state === 'granted') { try { const content = await Deno.readTextFile('/home/user/data/file.txt'); console.log('文件内容:', content); } catch (error) { console.error('读取文件失败:', error); } } else { console.log('权限被拒绝'); } } requestPermission(); |
3. 路径处理
在处理文件路径时，Deno提供了Deno.realPath方法来获取文件或目录的真实路径，这在处理符号链接等情况时非常有用。同时，使用path模块（Deno 标准库中的
https://deno.land/std/path/mod.ts）可以方便地进行路径拼接、解析等操作：
import { join, basename } from 'https://deno.land/std/path/mod.ts'; const baseDir = '/home/user'; const subDir = 'documents'; const fileName = 'example.txt'; const fullPath = join(baseDir, subDir, fileName); console.log('完整路径:', fullPath); console.log('文件名:', basename(fullPath)); |
通过以上从基础到进阶，再到实用技巧的学习，相信你已经对 Deno 操作本地文件有了全面而深入的理解。无论是简单的文本处理，还是复杂的文件系统管理，Deno 都能为你提供高效、可靠的解决方案，助力你在开发中更加得心应手。