如何让Vite React Docker容器同时实现卷同步与开发环境自动启动？

问题根源 #

你遇到的sh: vite: not found错误，核心原因是卷映射覆盖了容器内已安装的依赖目录：

• Docker构建阶段，你应该是在/frontend目录下执行了npm install，把vite等依赖装在了容器内的/frontend/node_modules里。
• 当你通过./frontend:/frontend挂载本地目录时，容器内/frontend下的所有内容（包括node_modules）会被本地目录的内容完全替换。
• 如果本地frontend目录没有运行过npm install（或node_modules不存在/不完整），容器启动后自然找不到vite命令；就算本地有node_modules，也可能因为容器与本地的系统架构、Node版本差异导致依赖无法正常运行。

解决方案 #

方法1：挂载卷时排除node_modules #

修改docker-compose.yml的卷配置，添加一条匿名卷来保留容器内的node_modules：

volumes:
  - ./frontend:/frontend
  - /frontend/node_modules

这条配置会让容器使用自己的node_modules目录，同时同步本地frontend下的其他文件（源码、配置等），既实现代码同步，又能正常运行npm run dev。

方法2：调整依赖安装路径（可选） #

如果不想用匿名卷，可以修改Dockerfile，把依赖安装到全局目录：

# 安装依赖到全局
RUN npm install -g vite
# 配置环境变量让系统能找到全局命令
ENV PATH="/usr/local/lib/node_modules/.bin:${PATH}"

这种方式下，vite会被安装到容器的全局路径，不会被本地卷覆盖，不过需要确保项目的package.json里的scripts能调用全局的vite。

验证步骤 #

1. 停止并删除现有容器：docker-compose down
2. 重新构建并启动容器：docker-compose up --build
3. 检查容器日志，确认npm run dev正常启动，同时修改本地代码，验证容器内是否同步更新。

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