Azure流水线执行npm publish到制品库后包缺失dist文件夹如何解决？

问题原因及修复方案 #

• 首先对齐Node.js版本：你当前流水线配置使用的是Node.js 10.x，和本地开发环境版本大概率不匹配，目前主流的前端构建工具（webpack 5、Vite、Rollup 3+等）均不兼容Node.js 10，会出现构建静默失败、不生成dist目录但无报错的情况。将流水线中NodeTool任务的versionSpec参数修改为你本地使用的Node.js大版本即可，示例如下：

- task: NodeTool@0
  inputs:
    versionSpec: '16.x' # 替换为你本地的Node.js版本，比如18.x、20.x
  displayName: 'Install Node.js'

• 验证构建产物是否生成：在npm run build和npm publish之间添加目录查看命令，确认dist文件夹确实在流水线的工作目录下生成，修改后的script步骤示例：

- script: |
    npm install
    npm run build
    ls -la # 新增命令，执行后可在流水线日志中查看当前目录下的所有文件，确认dist是否存在
    npm publish
  displayName: 'npm install and build and publish'

• 修正npm发布配置：如果dist目录在本地发布正常，但流水线发布被排除，大概率是npm默认继承了.gitignore的规则忽略了dist目录。可以在package.json中明确添加files字段声明要包含的发布内容，示例如下：

{
  "name": "your-package-name",
  "version": "1.0.0",
  "files": [
    "dist",
    "package.json",
    "README.md"
  ]
}

也可以在项目根目录新增.npmignore文件，覆盖gitignore的规则，不需要忽略dist目录即可。

• 调整发布命令：如果你的构建产物是生成在独立的dist目录且目录内已经包含了package.json等必要文件，可以直接将发布命令改为npm publish ./dist指定发布目录。

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