一次使用者列表导出功能开发完成后本地页面可以正常打开。点击按钮也能生成文件，pnpm build 一样通过。代码推到远程仓库后CI 却停在建立阶段。

CI 建立报错：模块解析失败

流水线日志里出现了这样的错误：

: Rollup failed to resolve import "xlsx" from "src/modules/user/utils/exportUsers.ts"

目录里的 node_modules 明明存在 xlsx建立命令也和 CI 一样。按理说，最初很容易把问题归到流水线缓存、镜像源或网络波动上，但日志已经说明。失败发生在模块解析阶段建立工具没有找到项目代码导入的包。

残留依赖掩盖了真实缺失

继续检查 package.json 后才发现，当前分支没有声明 xlsx。它来自另一个实验分支留下的安装结果：之前在那个分支执行过 pnpm add xlsx切回当前分支时Git 恢复了 package.json 和锁文件，却不会主动清理 node_modules 中多出来的包。

于是本地代码仍然能够执行：

import * as XLSX from 'xlsx';

痛点一： 本地能跑并不代表依赖已在仓库中声明；CI 在干净环境下会立刻暴露这种“隐形依赖”。

C​I 环境缺失依赖导致建立中断

CI 从空目录检出代码。再按照仓库中的锁文件安装，结果里没有 xlsx建立才报错。

修复依赖后出现的新错误：文件名大小写不一致

把 xlsx 加入 "dependencies" 并更新锁文件后流水线 执行。 这一次建立停在另一个位置：

Could not load src/modules/user/components/exportDialog.vue

仓库里的实际文件名是 ExportDialog.vue导入语句却写成了：

import ExportDialog from './exportDialog.vue';

C​ase‑Sensitive 文件程序差异是根源

痛点二： Windows 对方法大小写不敏感，本地建立把两者视为同一文件；Linux严格区分大小写，于是报错。

This issue is unrelated to .node_modules。Vite cache or package manager – it’s purely a cross‑platform path problem.

本地通过可能依赖了仓库之外的文件

C​ause: 前端开发目录会长期保留很多不受 Git 管理的内容，这些状态在切换分支时不会自动恢复到该分支的理想状态。

• 者在多个功能分支之间切换；某个分支增加依赖后即使另一个分支未声明该依赖，也可能继续访问磁盘上已经存在的包。
• 使用 pnpm *** xlsx/Pnpm list xlsx
• 删除现有安装结果并强制使用锁文件重新安装：

  rm -rf node_modules
  pnpm install --frozen-lockfile
  pnpm build
  

• CI 中一样使用冻结安装：

• 若仅在 Pnpm install --frozen-lockfile 时出现错误，则说明提交者忘记同步锁文件或遗漏了依赖声明。

文件名大小写为什么只在 CI 中暴露

C​ause: Linux 严格区分大小写，而 Windows 则不区分。即使本地能够成功导入，也会在 CI 上直接报错。

• 在 TypeScript 中开启强制大小写检查：

  {
  "compilerOptions": {
  "forceConsistentCasingInFileNames": true
  }
  }
  

• Git 在 Windows 上可能忽略仅更改大小写的重命名。推荐采用两步重命名来确保记录：

  git mv exportDialog.vue ExportDialog.tmp.vue
  git mv ExportDialog.tmp.vue ExportDialog.vue
  git status
  

• 确保 CI 与本地使用相同 Node.js 与 pnpm 版本，以免因不同解析实现产生差异。可以在 { “engines”: { 从“node”来看。“>=14” },“packageManager”: “pnpm@8” } 中声明统一版本。

在新目录中复现 CI 的安装过程

C​ause: 原项目目录常常混杂未提交文件、缓存和历史依赖，即使重新执行建立也难以确认是哪一步清理改变了结果。

• Create a clean worktree based on current commit:

  git worktree add ../order-admin-ci-check HEAD
  cd ../order-admin-ci-check
  git status # 确认工作区干净
  corepack enable
  pnpm install --frozen-lockfile
  pnpm build
  

• If build still fails with “cannot resolve xlsx”,dependency truly isn’t declared in repository.
• The worktree can be removed after verification:

  cd .. /..
  git worktree remove ../order-admin-ci-check
  

• This approach isolates repository state from local environment while preserving ongoing development in original folder.