You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用gh-pages部署GitHub应用时遇node_modules被.gitignore忽略问题

解决gh-pages部署时node_modules被.gitignore拦截的问题

下面是几个实用的解决办法,按顺序试试:

  • 清理gh-pages本地缓存
    gh-pages工具会在项目根目录生成一个隐藏的.gh-pages缓存文件夹,缓存出错可能导致这类问题。直接删掉这个文件夹(Windows需开启显示隐藏文件后操作),然后重新执行npm run deploy。

  • 检查.gitignore规则
    打开项目根目录的.gitignore文件,确认里面没有写dist/(会阻止gh-pages读取构建产物),也不要在dist目录里单独放置.gitignore文件。根目录的node_modules/规则是正常的,不会影响dist目录部署,除非有其他嵌套规则干扰。

  • 强制跳过gitignore检查(临时应急方案)
    修改package.json里的deploy脚本,添加--no-ignore参数,让gh-pages忽略.gitignore的限制:

    "scripts": {
      "deploy": "gh-pages -d dist --no-ignore"
    }
    

    保存后重新执行npm run deploy。

  • 重新构建再部署
    先执行项目构建命令(通常是npm run build)生成最新的dist目录,确保构建产物无问题后,再运行部署命令。

内容的提问来源于stack exchange,提问作者Zarina Nugmanova

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.20 12:09:20