4、核心模块 - path 与 os：路径处理与系统信息

好，咱们今天聊聊 Node.js 里两个特别实在的核心模块——path 和 os。说实话，这两个模块在刚入门时容易被忽略，但实际项目里几乎天天打交道。尤其是跨平台部署的时候，路径问题能坑得你怀疑人生。

4.1 路径处理：为什么不能直接拼字符串？

先问个问题：你在写文件路径时，是不是习惯用 + 或者模板字符串直接拼？

// 新手写法
const filePath = __dirname + '/data/' + filename;

嗯，我当年也这么干过。直到有一次在 Windows 服务器上部署，发现路径全炸了。为什么？因为 Windows 用反斜杠 \，而 Linux 和 macOS 用正斜杠 /。你写死的 / 在 Windows 下根本认不出来。

所以，永远不要手动拼接路径。用 path 模块，它帮你搞定一切。

4.2 path.join 与 path.resolve

这两个函数是路径处理的核心。我刚开始也分不清，后来总结了一句话：join 是拼接，resolve 是解析。

path.join：纯粹的路径拼接

path.join 就是把多个路径片段拼起来，它会自动处理分隔符。你只管传参数，它给你返回一个规范化的路径。

const path = require('path');

// 拼接路径
const fullPath = path.join('/user', 'local', 'bin');
console.log(fullPath); // 输出: /user/local/bin

// 处理相对路径
const relativePath = path.join('/user', '..', 'local', 'bin');
console.log(relativePath); // 输出: /local/bin

注意看，.. 被正确处理了。这就是 join 的聪明之处——它不会傻乎乎地保留 ..，而是帮你算好最终路径。

path.resolve：解析为绝对路径

path.resolve 的作用是：把一个相对路径解析成绝对路径。它会从右往左处理，直到生成一个绝对路径为止。

const path = require('path');

// 解析相对路径
const absPath = path.resolve('src', 'app.js');
console.log(absPath); // 输出: /当前工作目录/src/app.js

// 指定根路径
const customPath = path.resolve('/etc', 'config', 'app.conf');
console.log(customPath); // 输出: /etc/config/app.conf

// 处理 .. 和 .
const resolved = path.resolve('/user', '..', 'local', 'bin');
console.log(resolved); // 输出: /local/bin

这里有个关键点：path.resolve 的基准路径是当前工作目录（process.cwd()），而不是 __dirname。很多人踩过这个坑。

4.3 操作系统信息：os 模块

os 模块能帮你获取当前系统的各种信息。说实话，平时用得不多，但一旦需要做系统适配，它就是救命稻草。

const os = require('os');

// CPU 信息
console.log('CPU 架构:', os.arch());      // x64
console.log('CPU 核心数:', os.cpus().length); // 8

// 内存信息
console.log('总内存:', os.totalmem() / 1024 / 1024 / 1024 + 'GB');
console.log('空闲内存:', os.freemem() / 1024 / 1024 / 1024 + 'GB');

// 系统信息
console.log('操作系统:', os.platform());  // win32 / linux / darwin
console.log('主机名:', os.hostname());
console.log('临时目录:', os.tmpdir());

我记得有一次做性能监控工具，需要实时采集服务器的 CPU 和内存使用率。当时就是用 os.cpus() 和 os.freemem() 来获取原始数据，然后计算百分比。嗯，这个模块虽然小，但关键时刻真能顶上去。

4.4 环境变量：process.env

process.env 是 Node.js 中访问环境变量的入口。说白了，它就是系统环境变量的一个快照。

// 读取环境变量
const nodeEnv = process.env.NODE_ENV || 'development';
const port = process.env.PORT || 3000;
const dbUrl = process.env.DATABASE_URL;

console.log(`当前环境: ${nodeEnv}`);
console.log(`监听端口: ${port}`);

环境变量的好处是：代码和配置分离。你想想看，开发环境、测试环境、生产环境，数据库地址肯定不一样。如果写死在代码里，每次部署都要改代码，多麻烦。

// 使用 dotenv 加载 .env 文件
require('dotenv').config();

const dbPassword = process.env.DB_PASSWORD;
const jwtSecret = process.env.JWT_SECRET;

4.5 实战：跨平台路径处理工具

好，理论说完了，咱们来写个实战工具。这个工具的作用是：根据操作系统自动生成正确的路径。

需求很简单：

• 接收一个相对路径
• 自动判断当前操作系统
• 返回一个跨平台兼容的绝对路径

// cross-platform-path.js
const path = require('path');
const os = require('os');

/**
 * 跨平台路径处理工具
 * @param {string} relativePath - 相对路径
 * @param {string} [baseDir] - 基准目录，默认使用当前工作目录
 * @returns {string} 跨平台兼容的绝对路径
 */
function resolveCrossPlatformPath(relativePath, baseDir) {
  // 如果没有指定基准目录，使用当前工作目录
  const base = baseDir || process.cwd();
  
  // 使用 path.join 拼接路径，自动处理分隔符
  const fullPath = path.join(base, relativePath);
  
  // 使用 path.resolve 确保返回绝对路径
  const absolutePath = path.resolve(fullPath);
  
  // 获取当前操作系统
  const platform = os.platform();
  
  // 如果是 Windows，确保路径格式正确
  if (platform === 'win32') {
    // Windows 下路径可能包含反斜杠，但统一转为正斜杠更安全
    return absolutePath.replace(/\\/g, '/');
  }
  
  // Linux/macOS 直接返回
  return absolutePath;
}

// 测试
console.log(resolveCrossPlatformPath('data/config.json'));
// 输出示例（Linux）: /home/user/project/data/config.json
// 输出示例（Windows）: C:/Users/user/project/data/config.json

console.log(resolveCrossPlatformPath('../logs/app.log'));
// 输出示例: /home/user/logs/app.log

这个工具虽然简单，但非常实用。你可以在项目里封装一个类似的函数，所有路径操作都走它。这样即使以后换服务器、换操作系统，代码也不用改。

4.6 总结

今天咱们聊了三个核心知识点：

• path 模块：join 用于拼接，resolve 用于解析绝对路径。记住，永远不要手动拼路径。
• os 模块：获取系统信息，做跨平台适配时特别有用。
• process.env：环境变量的入口，实现配置与代码分离。

最后那个实战工具，我建议你直接复制到项目里用。别嫌它小，关键时刻能省你半天调试时间。嗯，下一章咱们聊聊文件系统操作，到时候还会用到今天学的路径处理知识。