如何将本地项目提交到 GitHub

1、首先在 GitHub 上创建一个新的仓库：

1. 登录 GitHub
2. 点击右上角 "+" 号
3. 选择 "New repository"
4. 填写仓库名称
5. 不要勾选 "Initialize this repository with a README"
6. 点击 "Create repository"

2、在本地项目中初始化 Git：

# 进入项目目录
cd your-project-path

# 初始化 Git
git init

# 添加所有文件到暂存区
git add .

# 创建第一次提交
git commit -m "first commit"

3、添加远程仓库并推送：

# 添加远程仓库（替换 USERNAME 和 REPO-NAME）
git remote add origin https://github.com/USERNAME/REPO-NAME.git

# 将本地 main 分支推送到远程
git branch -M main
git push -u origin main

4、如果你想忽略某些文件不提交，创建 .gitignore 文件：

node_modules
/dist

# local env files
.env.local
.env.*.local

# Log files
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*

# Editor directories and files
.idea
.vscode
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

5、如果遇到推送失败，可能需要：

# 设置 Git 用户信息
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

# 如果需要设置 token 认证（推荐）
# 1. 在 GitHub 设置中生成 Personal Access Token
# 2. 使用 token 替换密码进行认证

6、常用的 Git 命令：

git status

# 查看分支
git branch

# 创建并切换分支
git checkout -b feature-name

# 合并分支
git merge feature-name

# 拉取远程更新
git pull origin main

# 查看提交历史
git log

7、如果想将现有的远程仓库克隆到本地：

git clone https://github.com/USERNAME/REPO-NAME.git