在 GitHub 上新建仓库并上传代码是开发者最基础的操作之一。我们可以将其分为网页端操作和本地命令行操作两个阶段。第一步在 GitHub 网页端创建仓库登录你的 GitHub 账号。点击页面右上角的「」图标选择New repository。填写仓库信息Repository name: 你的项目名称例如my-first-project。Public/Private: 选择公开或私有。Add README (添加自述文件)README 是一个文本文件用来介绍你的项目是什么、怎么运行、用了什么技术。建议开启 (On)开启后GitHub 会自动为你创建一个文件。它是项目的“门面”没有 README 的仓库看起来像个“空壳”。Add .gitignore (添加忽略文件)告诉 Git 哪些文件不需要上传到服务器比如自动生成的日志、临时文件、或者存有密码的配置文件。比如选择 Python 后它能精准地把 Python 运行产生的“废纸屑”缓存文件__pycache__/、虚拟环境venv/、.env/、编译文件.pyc等拦住但你写的任何正式文件不管是 Python 还是其他语言都能顺利通过。Add license (添加授权许可)建议选择 MIT规定别人可以如何使用、修改和分享你的代码。注意如果你本地已经有代码了不要勾选 Add a README file、.gitignore 或 license保持仓库是空的。否则会有冲突必须先pull拉取处理合并冲突在进行Push。点击底部的Create repository按钮。第二步在本地上传代码命令行创建成功后GitHub 会显示一个包含仓库地址HTTPS 或 SSH的页面。请打开你服务器的终端Terminal 或 Git Bash进入你的项目文件夹依次输入以下命令1. 下载目标仓库把刚刚创建的仓库下载到本地git clone https://github.com/username/my-first-project.git2. 更新代码对仓库进行代码和数据的更新3. 查看修改状态 (可选)在操作之前建议先确认你改动了哪些文件。git status这会列出所有被修改Modified或新创建Untracked的文件。4. 将文件添加到暂存区添加所有改动这里的 . 代表添加当前目录下的所有文件git add .仅添加特定文件git add README.md # 比如你刚修改完 README5. 提交代码到本地仓库git commit -m Initial Code Submission6. 设置主分支名称GitHub 现在默认使用main作为主分支名可以先执行 git branch 进行确认如果输出为 * main说明你本地已经是main了不需要执行该步骤git branch -M main注意如果执行git branch发现什么都没有输出是因为你还没有进行过任何commit。Git 要求至少有一个提交后分支才会真正存在7. 推送更新到 GitHubgit push -u origin main注如果是第一次推送可能会弹出窗口要求你输入 GitHub 的账号密码或Personal Access Token (PAT)。可能遇到的问题1身份报错需要配置用户名和邮箱推送代码时显示以下内容Author identity unknown *** Please tell me who you are. Run git config --global user.email youexample.com git config --global user.name Your Name to set your accounts default identity. Omit --global to set the identity only in this repository. fatal: unable to auto-detect email address需要执行以下语句修改配置信息# 设置全局用户名 git config --global user.name Your Name # 设置全局邮箱建议使用 GitHub 绑定的邮箱 git config --global user.email youexample.com2权限报错Personal Access Token (个人访问令牌简称 PAT)推送代码时显示以下内容Username for https://github.com: Username Password for https://Usernamegithub.com: remote: Invalid username or token. Password authentication is not supported for Git operations. fatal: Authentication failed for https://github.com/Username/my-first-project.git/原因这是因为 GitHub 在 2021 年就停止了对 HTTPS 方式使用“账号密码”进行 Git 操作的支持。现在的安全策略要求当你使用终端命令行推送代码时必须使用Personal Access Token (个人访问令牌简称 PAT)来代替你平时的登录密码。解决方法生成并使用 Token第一步在 GitHub 网页端生成 Token点击 GitHub 页面右上角头像选择Settings。在左侧菜单最下方找到Developer settings。选择Personal access tokens-Tokens (classic)。点击Generate new token-Generate new token (classic)。设置Note比如写 LAM-Pre-pushExpiration有效期建议选 90 天或更久。勾选权限最起码要勾选repo这是操作仓库的核心权限。点击最下方的Generate token。非常重要复制生成的那串以ghp_开头的长字符。它只会出现这一次请先找个地方保存好。第二步在终端重新 Push回到你的终端再次运行推送命令git push origin mainUsername: 输入Username。Password:不要输入你的登录密码直接右键粘贴你刚才复制的那串ghp_开头的Token注意在终端输入密码时屏幕不会显示任何字符直接回车即可。避免反复输入 Token执行以下指令让服务器记住你的 Tokengit config --global credential.helper store 核心命令总结表操作命令作用初始化git init让 Git 开始管理这个文件夹暂存git add .把修改过的文件放入“待提交清单”提交git commit -m 描述给这次修改存一个快照存档关联git remote add origin url告诉本地 Git 远程服务器在哪推送git push -u origin main把本地的存档同步到 GitHub 网页