React应用运行正常但编译报错：webpack-dev-server模块未找到

架构老林

2026-7-26

问题分析与解决办法

核心原因

你的项目路径里包含特殊字符#（bytewise_Project#1），webpack和Node.js的模块解析器会把#识别为URL锚点，导致无法正确解析webpack-dev-server/client/index.js的完整路径，进而触发模块找不到的错误。虽然应用能临时运行，但编译环节的路径解析逻辑会触发这个问题。

解决步骤

修改项目文件夹名称：将包含#的文件夹名bytewise_Project#1改为无特殊字符的名称，例如bytewise_Project_1或bytewise-Project1。
清理依赖并重装：
1. 删除项目根目录下的node_modules文件夹
2. 删除package-lock.json（使用npm时）或yarn.lock（使用yarn时）文件
3. 执行命令重装依赖：
```
npm install
# 或使用yarn的话
yarn install
```
重启开发服务器：关闭当前运行的npm start进程，重新启动服务，编译错误即可消除。