TypeScript中如何获取Linux用户的Umask设置

可以在依托Node.js运行的TypeScript代码中直接获取当前用户的umask配置，用于配合fs.writeFile的参数配置，具体说明如下：

• 核心获取方式：直接调用Node.js全局对象process上的无参方法process.umask()，就可以拿到当前进程继承自系统用户的umask数值，这个调用是只读操作，不会修改系统或进程的umask配置，没有副作用。
• TypeScript类型支持：只要项目中安装了@types/node类型依赖，TS对该方法有完整的类型提示，返回值为number类型，不需要额外编写类型声明。
• 和fs.writeFile的配合逻辑：
  • 如果你没有手动传入options中的mode参数，fs.writeFile默认使用0o666作为初始文件权限，会自动套用当前umask计算最终文件权限，和Linux shell下touch命令生成文件的权限规则完全一致，不需要你手动读取umask做计算。
  • 如果你需要自定义初始权限（比如写shell脚本需要初始带执行权限，设mode: 0o777），fs模块同样会自动套用umask规则计算最终权限，不需要手动做位运算。
• 注意事项：
  • 不要为了调整文件权限调用传参版本的process.umask(新值)，这会修改整个Node.js进程全局的umask配置，影响后续所有文件操作的默认权限，存在安全隐患。
  • 该方法仅在Node.js运行时可用，如果TypeScript代码运行在浏览器环境，无法获取操作系统层面的umask配置。

代码示例 #

import { writeFile } from 'fs/promises';

// 读取当前umask，转8进制打印和shell执行umask命令的输出格式对齐
const umask = process.umask();
console.log(`当前用户umask: 0o${umask.toString(8)}`);

// 普通文件写入，不传mode自动适配umask
await writeFile('./demo.txt', '普通文本内容');

// 可执行文件写入，自定义初始mode，自动适配umask
await writeFile('./demo.sh', '#!/bin/bash\necho "hello"', {
  mode: 0o777
});

常见误区：很多人会手动计算mode & (~umask)再传给fs方法，实际上这是多余操作，操作系统层面的文件写入接口本身就会自动应用umask规则，手动计算反而可能因为逻辑错误导致权限不符合预期。

内容的提问来源于stack exchange，提问作者user18457038