需通过git命令行或github desktop上传本地文件夹至github仓库：先安装配置git，再初始化本地仓库、关联远程仓库、添加提交文件，最后推送；也可用github desktop图形化操作，或网页端拖拽上传小规模文件。
如果您希望将本地文件夹上传至 GitHub 仓库，需通过 Git 命令行工具完成初始化、暂存、提交与推送操作。以下是具体执行步骤：
一、安装并配置 Git
在上传前，必须确保本地已安装 Git 并完成基础身份配置，否则后续命令将无法识别用户信息或执行远程操作。
1、访问 https://git-scm.com/downloads 下载对应操作系统的 Git 安装包并完成安装。
2、打开终端（Windows 用户可使用 Git Bash 或 Windows Terminal），依次执行以下两条命令：
3、git config --global user.name "YourGitHubUsername"
4、git config --global user.email "your_email@example.com"
二、创建本地 Git 仓库
需在目标文件夹内初始化 Git 仓库，使其具备版本控制能力，这是后续提交的前提条件。
1、在文件资源管理器中定位到待上传的本地文件夹，右键选择“Git Bash Here”（若未显示则进入该路径后手动打开终端）。
2、输入命令：git init，回车后该目录即成为 Git 仓库。
3、执行 ls -a 确认目录中已生成 .git 隐藏文件夹。
三、关联远程 GitHub 仓库
本地仓库需绑定 GitHub 上已创建的目标仓库地址，才能将内容推送过去。此步骤不可跳过，否则推送会失败。
1、登录 GitHub 网站，点击右上角“+”号，选择“New repository”，填写仓库名、描述，保持“Public”，取消勾选“Initialize this repository with a README”，点击“Create repository”。
2、在新仓库页面，复制顶部显示的 HTTPS 地址（形如 https://github.com/username/repo-name.git）。
3、回到终端，执行：git remote add origin https://github.com/username/repo-name.git（将 URL 替换为实际复制的地址）。
4、验证是否成功：输入 git remote -v，应显示 origin 对应的 fetch 和 push URL。
四、添加文件并提交到本地仓库
需将文件从工作区移入暂存区，再提交至本地仓库的 HEAD，这是上传前的必要中间状态。
1、输入 git status 查看当前未跟踪的文件列表。
2、执行 git add . 将当前目录下所有文件及子目录递归加入暂存区（若仅添加特定文件，可用 git add filename）。
3、运行 git commit -m "Initial commit" 完成本地提交，引号内为提交说明，建议简明描述内容。
五、推送到 GitHub 远程仓库
将本地提交的内容同步至 GitHub 服务器，使文件正式出现在网页端仓库中。
1、首次推送需指定分支名称，执行：git push -u origin main（若仓库默认分支为 master，则替换为 master）。
2、终端提示输入 GitHub 账户密码时，若启用双重验证，需使用个人访问令牌（PAT）代替密码；令牌可在 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic) 中生成。
3、推送成功后，刷新 GitHub 仓库网页，确认文件已完整显示。
六、使用 GitHub Desktop 图形化上传
对命令行不熟悉者，可通过 GitHub Desktop 应用实现可视化操作，全程无需输入命令，降低出错概率。
1、访问 https://desktop.github.com 下载并安装 GitHub Desktop。
2、启动应用，点击左上角“File” → “Add Local Repository”，浏览并选中目标文件夹，点击“Add Repository”。
3、点击右上角“Publish repository”，填写仓库名、描述，在“Owner”处选择您的 GitHub 账户，勾选“Keep this code private”按需设置，点击“Publish Repository”。
4、应用自动完成初始化、提交与推送，完成后 GitHub 网页端即可查看该仓库。
七、通过拖拽方式上传单个文件夹（限小规模）
适用于无子目录、文件总数少于 100 个且总大小低于 25MB 的简单场景，直接在网页端操作，无需本地 Git 配置。
1、进入 GitHub 目标仓库主页，点击“Add file” → “Upload files”。
2、将整个文件夹拖入虚线框区域，或点击后选择该文件夹内的全部文件（注意：不能直接拖入空文件夹，需展开选择内容）。
3、在页面底部“Commit changes”栏填写 summary，选择“Commit directly to the main branch”，点击“Commit changes”。
4、刷新页面，确认文件结构已按原层级呈现（但此方式不保留 Git 历史记录，也不支持后续增量更新）。
