如何使用Visual Studio Code上传超大型Next.js项目至GitHub

核心思路：用Git命令行上传（替代手动拖拽），先清理冗余文件减小体积 #

GitHub手动拖拽有文件数量和大小限制，官方推荐用Git命令行操作，同时通过忽略不必要的文件大幅压缩项目体积（你的600MB大概率是node_modules这类依赖包，完全不需要上传）。

步骤1：清理冗余文件（关键！） #

1. 在项目根目录创建.gitignore文件，写入以下适配Next.js项目的忽略规则：

   # dependencies
   node_modules/
   .pnp
   .pnp.js
   
   # testing
   coverage/
   
   # next.js
   .next/
   out/
   
   # production
   build/
   
   # misc
   .DS_Store
   *.pem
   
   # debug
   npm-debug.log*
   yarn-debug.log*
   yarn-error.log*
   
   # local env files
   .env*.local
   

2. 删除本地的node_modules文件夹（后续需要依赖时，执行npm install或yarn install重新安装即可）。

步骤2：初始化Git并关联GitHub仓库 #

1. 打开终端，进入项目根目录，执行：

   git init
   

2. 去GitHub创建一个空仓库（不要勾选「Add a README file」「Add .gitignore」等初始化选项）。
3. 复制仓库的HTTPS或SSH地址，执行关联命令：

   git remote add origin <你的GitHub仓库地址>
   

步骤3：提交并推送代码 #

1. 添加所有未被忽略的文件到暂存区：

   git add .
   

2. 提交到本地仓库：

   git commit -m "Initial commit: 上传Next.js项目当前进度"
   

3. 推送到GitHub远程仓库：

   git push -u origin main
   

   （如果你的GitHub默认分支是master，把main换成master即可）

如果存在单个超过100MB的大文件（比如视频、大型静态资源） #

GitHub单个文件上限是100MB，若有这类文件，用Git LFS处理：

1. 安装Git LFS（已安装可跳过）：

   git lfs install
   

2. 追踪需要上传的大文件类型，比如：

   git lfs track "*.mp4"
   git lfs track "public/large-design.psd"
   

3. 重新执行git add .、git commit、git push即可。

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