Vite配置加载失败：Django+Vite项目无法启动开发服务器

问题场景 #

开发Vite+React+Django的Web应用，执行npm run dev启动开发服务器时触发报错，同一配置在另一台电脑可正常运行，已重装Node两次无效。

报错信息 #

failed to load config from C:\Users\vinny\OneDrive\Documents\CS49999\ct-scheduling\vite.config.js
error when starting dev server:
TypeError: Cannot redefine property: File
    at Function.defineProperty (<anonymous>)
    at Object.<anonymous> (C:\Users\vinny\OneDrive\Documents\CS49999\ct-scheduling\node_modules\@babel\core\lib\index.js:7:8)
    at Module._compile (node:internal/modules/cjs/loader:1241:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1295:10)
    at Module.load (node:internal/modules/cjs/loader:1091:32)
    at Module._load (node:internal/modules/cjs/loader:938:12)
    at Module.require (node:internal/modules/cjs/loader:1115:19)
    at require (node:internal/modules/helpers:130:18)
    at Object.<anonymous> (C:\Users\vinny\OneDrive\Documents\CS49999\ct-scheduling\node_modules\@babel\core\lib\config\helpers\config-api.js:16:9)
    at Module._compile (node:internal/modules/cjs/loader:1241:14)

vite.config.js配置 #

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [react()],
  
  build: {
    manifest: true,
    rollupOptions: {
      input: './src/main.jsx',
    },
  },
  
  server: {
    proxy: {
      '/api': {
          target: 'http://USERNAME.pythonanywhere.com',
          changeOrigin: true,
      }
    }
  }
})

解决方案 #

• 彻底清理依赖并重装

  1. 删除项目根目录下的node_modules文件夹
  2. 删除package-lock.json文件
  3. 执行npm install重新安装所有依赖

• 对齐Node版本

  1. 在能正常运行的电脑上执行node -v查看Node版本
  2. 在当前电脑安装相同大版本的Node（推荐用nvm管理版本，避免全局环境冲突）
  3. 确保Node版本符合Vite要求（Vite 4.x要求Node 14.18+，最新版建议16+）

• 排查全局包冲突

  1. 执行npm list -g @babel/core检查是否全局安装了@babel/core
  2. 如果有全局安装，执行npm uninstall -g @babel/core卸载，避免和项目本地包冲突

• 避开OneDrive同步目录
  项目存储在OneDrive目录下可能导致文件损坏或权限问题：

  1. 将项目文件夹复制到本地非同步目录（如C:\Users\vinny\Documents\CS49999\ct-scheduling-local）
  2. 在新目录下重新执行npm install和npm run dev

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