添加VuePress dev脚本启动失败，求本地8080端口运行解决方案

你遇到的ENOSPC错误本质是Linux系统的文件监听上限不足导致的——VuePress在开发模式下需要持续监听大量文件的变化（尤其是node_modules里的依赖文件），而系统默认的inotify监听数量上限太低，触发了这个报错。好在vuepress build不需要持续监听文件，所以能正常运行。

下面给你两种可行的解决办法：

方法一：调高系统文件监听上限（永久生效） #

这个方法直接修改系统配置，从根源解决监听数量不足的问题：

1. 执行命令修改sysctl配置：

   echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
   

2. 让配置立即生效：

   sudo sysctl -p
   

之后再运行npm run dev，VuePress默认会在8080端口启动本地服务；如果8080端口被占用，它会自动切换到其他可用端口。

方法二：限制VuePress的监听范围（更轻量） #

如果不想修改系统配置，可以调整dev脚本，让VuePress只监听你的文档目录（比如项目里的docs文件夹），减少需要监听的文件总数：
修改package.json里的scripts字段：

"scripts": {
  "build": "vuepress build",
  "dev": "vuepress dev docs",
  "test": "rm -rf .vuepress/dist && npm run build && stat .vuepress/dist/index.html"
}

这样VuePress只会监听docs目录下的文件变化，不会去扫描node_modules里的内容，也能避开监听上限的问题。

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