Cornerstone 2.0执行stencil start命令报错：找不到webpack.dev.js模块

嘿，我之前帮不少开发者搞定过Cornerstone主题的这类问题，你的报错很典型——系统在加载stencil.conf.js第2行的时候，找不到指定的webpack.dev.js文件，别慌，咱们一步步来修复：

1. 先确认文件有没有丢失 #

首先去你的Cornerstone 2.0项目根目录瞅一眼，看看webpack.dev.js这个文件是不是真的没了：

• 如果确实丢失了，要么从Bigcommerce官方的Cornerstone 2.0仓库重新拉取这个文件，要么直接重新克隆一份完整的项目代码
• 要是你用Git做版本控制的话，也可以从历史记录里把误删的文件恢复回来

2. 重新安装依赖（大概率能解决问题） #

很多时候这种“找不到模块”的问题，都是依赖安装不彻底或者出了bug导致的，按这个步骤操作：

• 先删掉项目根目录下的node_modules文件夹，还有package-lock.json（用Yarn的话就删yarn.lock）
• 打开终端切换到项目根目录，执行安装命令：

  npm install
  

  用Yarn的话就运行：

  yarn install
  

• 等依赖安装完成后，再试试执行stencil start，应该就能正常启动了

3. 检查Stencil CLI版本兼容性 #

Cornerstone 2.0对Stencil CLI的版本有特定要求，版本不匹配也可能引发这类问题：

• 先查看当前安装的Stencil CLI版本：

  stencil --version
  

• 对照Cornerstone 2.0的官方说明，确认需要的CLI版本。要是版本不对，就升级或者降级：
  • 升级到最新版：

    npm install -g @bigcommerce/stencil-cli
    

  • 降级到指定版本（比如假设需要v1.21.0）：

    npm install -g @bigcommerce/stencil-cli@1.21.0
    

4. 验证stencil.conf.js的引用路径 #

打开stencil.conf.js文件，检查第2行引用webpack.dev.js的路径是否正确，有没有拼写错误，确保文件确实在同一目录下。要是路径写错了，修正后再重新启动试试。

如果上面的方法都试过还是不行，那就清空npm缓存后再重新安装依赖：

npm cache clean --force

然后重复步骤2的安装操作，应该就能解决问题了。

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