Gitlab CI/CD流水线构建失败：Vue项目.md文件依赖未找到问题求助

核心原因说明 #

本地构建正常、Docker CI环境构建失败的核心差异来自于Linux容器的文件系统大小写敏感、CI拉取的文件完整性、依赖版本一致性三个维度，可按以下步骤逐一排查修复：

• 校验文件名大小写匹配
  macOS/Windows默认文件系统大小写不敏感，Docker底层Linux系统大小写完全敏感。请逐一核对代码中import语句的md文件名和实际存储的文件名大小写100%一致，比如导入语句写import httpMd from '@views/pages/support/content/http.md'，要确保实际文件名为全小写的http.md，不存在HTTP.md/Http.md这类大小写偏差。
• 确认.gitignore未屏蔽md文件
  检查项目根目录和子目录下的.gitignore文件，排查是否存在*.md这类全局忽略规则，如果有需添加排除规则保证业务用md文件被提交到Git仓库：

  # .gitignore 添加排除规则
  !src/**/*.md
  

  规则添加后重新提交三个md文件，保证CI拉取代码时能拿到对应文件。
• 修正raw-loader与别名配置
  确保vue.config.js中的raw-loader规则覆盖所有md文件，同时@views别名路径配置正确，参考配置如下：

  const path = require('path')
  module.exports = {
    chainWebpack: config => {
      // 注册raw-loader处理md文件
      config.module
        .rule('md')
        .test(/\.md$/)
        .use('raw-loader')
        .loader('raw-loader')
        .end()
      // 确认@views别名指向正确路径
      config.resolve.alias
        .set('@views', path.resolve(__dirname, 'src/views'))
    }
  }
  

• 锁定依赖版本保证环境一致性
  在package.json中固定raw-loader版本，同时将package-lock.json/yarn.lock提交到仓库，避免CI自动安装的依赖版本与本地不一致引发兼容性问题：

  "devDependencies": {
    "raw-loader": "^4.0.2"
  }
  

• 增加CI调试步骤定位问题
  可在.gitlab-ci.yml的构建脚本前添加文件列表打印命令，确认CI环境中对应路径下的文件是否存在：

  script:
    - ls src/views/pages/support/content/ # 构建前先打印目录文件
    - npm run build
  

  执行CI任务后查看日志输出，即可快速判断是文件未拉取还是编译配置问题。

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