Gulp任务源用符号链接遇ENOENT错误，需将符号链接加入tar包

我刚好碰到过类似的问题，核心原因是Gulp（准确说是它依赖的vinyl-fs）默认会跟随符号链接去读取指向的目标文件，而不是把符号链接本身当作源文件处理——这就导致当目标文件不存在或者路径有误时抛出ENOENT错误，同时也不符合你想要打包符号链接本身的需求。

下面是直接可行的解决方案：

关键配置：禁用符号链接跟随 #

vinyl-fs提供了followSymlinks选项，设置为false就能让Gulp直接处理符号链接文件本身，而不是解析它指向的路径。我们可以结合gulp-tar来完成打包任务：

步骤1：安装依赖 #

首先确保你安装了必要的包：

npm install gulp gulp-tar

步骤2：编写Gulp任务 #

直接在Gulp配置里给src方法添加followSymlinks: false参数即可：

const gulp = require('gulp');
const tar = require('gulp-tar');

gulp.task('default', function() {
  // 重点是添加followSymlinks: false，阻止解析符号链接指向的文件
  return gulp.src('/home/dorb/symfile', { followSymlinks: false })
    // 将符号链接打包成指定名称的tar包
    .pipe(tar('symlink-only.tar'))
    // 输出到dist目录（目录不存在会自动创建）
    .pipe(gulp.dest('./dist'));
});

为什么这个方案有效？ #

• 当followSymlinks设为false时，Gulp会把符号链接当作一个独立的文件实体读取，不会尝试打开它指向的路径，从根源上避免了ENOENT错误。
• 打包后的tar包会完整保留这个符号链接的元信息，不会替换成它指向的文件，完全符合你后续自行处理的需求。

额外注意事项 #

• 先确认你的符号链接/home/dorb/symfile确实存在，可以用ls -l /home/dorb/symfile命令检查。
• 如果需要打包多个符号链接，只需要在src里传入路径数组即可，比如['/path/to/sym1', '/path/to/sym2']。

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