ubuntu nodejs跨平台开发注意事项

Ubuntu 下进行 Node.js 跨平台开发的关键注意事项

一 路径与文件系统

跨平台开发，第一道坎往往就是路径。处理不好，代码在Ubuntu上跑得好好的，一到Windows就“找不到文件”。

先说路径拼接，这事儿千万别自己手写斜杠。老老实实用 path.join 或者 path.resolve，让Node.js的库去处理不同操作系统的差异。到了ESM模块，情况有点变化，__dirname 不能直接用了。那怎么获取当前文件目录呢？标准做法是组合使用 import.meta.url、fileURLToPath 和 dirname。具体代码长这样：

import { fileURLToPath } from ‘url’; import { dirname, join } from ‘path’; const __dirname = dirname(fileURLToPath(import.meta.url));

接下来是行尾符，一个经典的“隐形杀手”。Windows用\r\n，而Unix/Linux用\n。读写文本文件时，如果没处理好，很容易导致内容校验失败或者解析出错。保险起见，要么在读写时显式指定换行符为\n，要么直接用Node.js提供的os.EOL。如果需要规范化已有的文本内容，用正则表达式 /\r?\n/g 进行替换是个通用方案。

最后，别忘了Windows那个著名的“260字符”路径长度限制。如果你的项目目录层级很深，或者文件名特别长，在Windows上就可能触发ENAMETOOLONG错误。应对策略无非两条：一是尽量优化项目结构，缩短路径；如果实在避不开，可以考虑为Windows环境启用长路径支持，或者干脆把工作区移到更靠近根目录的位置。

二 环境变量与 npm 脚本

环境变量和npm脚本是项目配置和构建的枢纽，但它们的语法在Windows和类Unix系统上可不太一样。

在npm scripts里设置环境变量，最省心的工具就是cross-env。用它，你可以统一写成 cross-env VAR=value，彻底告别Windows的set VAR=value和Unix的VAR=value之争。在代码中访问变量，自然是用process.env。当需要创建子进程时，最佳实践是通过child_process的env选项显式传递环境变量，而不是依赖进程外部的、不确定的环境。

这里还有个细节：环境变量的大小写问题。Windows（除了MSYS这类环境）通常不区分大小写，而Unix系系统是严格区分的。为了跨平台安全，团队内部最好统一命名规范（比如全大写），并在必要时做大小写映射或校验。

一些常见的系统变量，获取方式也需要统一：

• 用户家目录：在Unix是HOME，在Windows是USERPROFILE。代码里别直接读这些变量，用os.homedir()。
• 临时目录：Unix是TMPDIR，Windows是TMP或TEMP。同样，请使用os.tmpdir()。
• 主机名：Unix是HOSTNAME，Windows是COMPUTERNAME。统一用os.hostname()获取。