Netlify自动部署Vue项目失败：组件路径无法解析

本地手动部署（在VSC终端执行npm run build后拖拽dist文件夹到Netlify）可正常运行，但代码提交后自动部署时构建失败，报错信息：
Could not resolve ./PcBuilderComponentCardList.vue from src/components/PcBuilderCard.vue

PcBuilderCard组件中的导入语句如下：

<script setup>
import PcBuilderComponentCardList from './PcBuilderComponentCardList.vue';
</script>

构建失败日志 #

9:46:42 AM: $ npm run build
9:46:42 AM: > vue@0.0.0 build
9:46:42 AM: > vite build
9:46:42 AM: vite v4.4.9 building for production...
9:46:42 AM: transforming...
9:46:46 AM: ✓ 1407 modules transformed.
9:46:46 AM: ✓ built in 3.36s
9:46:46 AM: Could not resolve ./PcBuilderComponentCardList.vue from src/components/PcBuilderCard.vue
9:46:46 AM: file: /opt/build/repo/frontend/vue/src/components/PcBuilderCard.vue
9:46:46 AM: error during build:
9:46:46 AM: RollupError: Could not resolve ./PcBuilderComponentCardList.vue from src/components/PcBuilderCard.vue
9:46:46 AM:     at error (file:///opt/build/repo/frontend/vue/node_modules/rollup/dist/es/shared/node-entry.js:2245:30)
9:46:46 AM:     at ModuleLoader.handleInvalidResolvedId (file:///opt/build/repo/frontend/vue/node_modules/rollup/dist/es/shared/node-entry.js:24736:24)
9:46:46 AM:     at file:///opt/build/repo/frontend/vue/node_modules/rollup/dist/es/shared/node-entry.js:24698:26
9:46:46 AM: ​
9:46:46 AM: build.command failed                                        
9:46:46 AM: ────────────────────────────────────────────────────────────────
9:46:46 AM: ​
9:46:46 AM:   Error message
9:46:46 AM:   Command failed with exit code 1: npm run build (https://ntl.fyi/exit-code-1)
9:46:46 AM: ​
9:46:46 AM:   Error location
9:46:46 AM:   In Build command from Netlify app:
9:46:46 AM:   npm run build
9:46:46 AM: ​
9:46:46 AM:   Resolved config
9:46:46 AM:   build:
9:46:46 AM:     base: /opt/build/repo/frontend/vue
9:46:46 AM:     command: npm run build
9:46:46 AM:     commandOrigin: ui
9:46:46 AM:     publish: /opt/build/repo/frontend/vue/dist
9:46:46 AM:     publishOrigin: ui
9:46:47 AM: Failed during stage 'building site': Build script returned non-zero exit code: 2 (https://ntl.fyi/exit-code-2)
9:46:47 AM: Build failed due to a user error: Build script returned non-zero exit code: 2
9:46:47 AM: Failing build: Failed to build site
9:46:48 AM: Finished processing build request in 24.241s

构建设置 #

排查方向与解决步骤 #

• 文件名大小写问题：本地Windows系统不区分文件名大小写，但Netlify构建环境为Linux，严格区分。检查PcBuilderComponentCardList.vue实际文件名与导入语句的拼写，确保大小写完全一致，修正后提交到Git。
• 文件未提交到Git：确认该组件文件是否已被Git追踪，执行git status查看状态，若未追踪，运行git add src/components/PcBuilderComponentCardList.vue后提交推送。
• .gitignore规则问题：检查项目根目录的.gitignore文件，确认未意外忽略.vue文件或该组件所在路径。
• 模拟远程构建环境：本地执行git clean -df清除未追踪文件后，再运行npm run build，看是否出现相同错误，排查本地与远程仓库的文件差异。

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