在Node.js中 path 模块的基本用法-CSDN博客

本文链接：https://blog.csdn.net/yuanlong12178/article/details/140929054

Node.js作为一种流行的JavaScript运行环境，因其高效的性能和强大的库而受到广泛使用。为了处理文件路径，Node.js内置了一个功能强大的路径模块（path）。在这篇博客中，我们将深入探讨 path 模块的基本用法，包括其主要方法及实际示例代码。

1. 引入 `path` 模块

在使用 path 模块之前，我们首先需要将其引入到我们的Node.js应用中。可以通过下面的代码实现：

const path = require('path');

2. `path` 模块的主要方法

path 模块提供了一些常用的方法，以下是几个关键方法的介绍：

path.join()
path.resolve()
path.basename()
path.dirname()
path.extname()
path.parse()
path.format()

我们将逐个解释这些方法，并提供示例代码以帮助理解它们的用法。

3. `path.join()`

path.join() 方法用于将多个路径片段连接到一起，自动处理路径分隔符。

示例代码：

const path = require('path');

const directory = 'users';
const subdirectory = 'documents';
const filename = 'file.txt';

const fullPath = path.join(directory, subdirectory, filename);
console.log(fullPath); // 输出： users/documents/file.txt  (在Windows上为 users\documents\file.txt)

在上述代码中，path.join 生成了一个完整的路径，而不必担心不同操作系统的路径分隔符。

4. `path.resolve()`

path.resolve() 方法将路径或路径片段的序列解析为绝对路径。

示例代码：

const path = require('path');

console.log(path.resolve('users', 'documents', 'file.txt')); 
// 输出：绝对路径，例如：/home/user/users/documents/file.txt

这里的输出将为当前工作目录下的完整绝对路径。

5. `path.basename()`

path.basename() 方法返回路径的最后部分。

示例代码：

const path = require('path');

const fullPath = '/users/documents/file.txt';
const baseName = path.basename(fullPath);
console.log(baseName); // 输出：file.txt

这个方法可以用来快速获取文件名。

6. `path.dirname()`

path.dirname() 方法返回路径的目录部分。

示例代码：

const path = require('path');

const fullPath = '/users/documents/file.txt';
const dirName = path.dirname(fullPath);
console.log(dirName); // 输出：/users/documents

以上代码证明了path.dirname()有效地提取了路径中不包括文件名的部分。

7. `path.extname()`

path.extname() 方法返回文件扩展名。

示例代码：

const path = require('path');

const filePath = '/users/documents/file.txt';
const extName = path.extname(filePath);
console.log(extName); // 输出：.txt

此方法在处理文件时非常有用，尤其是在需要根据扩展名对文件进行分类时。

8. `path.parse()`

path.parse() 方法将路径字符串解析为一个对象，该对象包含路径的相关信息。

示例代码：

const path = require('path');

const fullPath = '/users/documents/file.txt';
const parsedPath = path.parse(fullPath);
console.log(parsedPath);
/*
输出：
{
  root: '/',
  dir: '/users/documents',
  base: 'file.txt',
  ext: '.txt',
 : 'file'
}
*/

解析后的对象为你提供了关于路径的各个组成部分的信息，非常方便。

9. `path.format()`

path.format() 方法与 path.parse() 方法相反，可以通过对象构建出路径字符串。

示例代码：

const path = require('path');

const pathObject = {
  root: '/',
  dir: '/users/documents',
  base: 'file.txt',
  ext: '.txt',
  name: 'file'
};

const formattedPath = path.format(pathObject);
console.log(formattedPath); // 输出：/users/documents/file.txt

10. 组合示例

接下来，让我们组合所有的 path 模块方法以构建一个应用程序示例。

示例代码：

const path = require('path');

const userDir = 'users';
const documentDir = 'documents';
const fileName = 'report.txt';

// 1. 使用 join() 构建路径
const fullPath = path.join(userDir, documentDir, fileName);
console.log('Full Path:', fullPath);

// 2. 使用 resolve() 获取绝对路径
const absolutePath = path.resolve(fullPath);
console.log('Absolute Path:', absolutePath);

// 3. 获取文件名和扩展名
console.log('File Name:', path.basename(fullPath));
console.log('Extension:', path.extname(fullPath));

// 4. 解析路径
const parsedPath = path.parse(fullPath);
console.log('Parsed Path:', parsedPath);

// 5. 格式化路径
const formattedPath = path.format(parsedPath);
console.log('Formatted Path:', formattedPath);