# 将新项目提交到GitHub仓库完整指南

## 方法一：从本地项目开始

### 1. 在GitHub上创建新仓库
- 登录 GitHub
- 点击右上角 "+" → "New repository"
- 填写仓库名称和描述
- 选择公开(Public)或私有(Private)
- **不要**初始化 README、.gitignore 或 license（因为本地已有项目）
- 点击 "Create repository"

### 2. 在本地项目初始化Git
```bash
cd /path/to/your/project
git init
```

### 3. 添加文件到暂存区
```bash
git add .
# 或者添加特定文件
git add filename
```

### 4. 提交更改
```bash
git commit -m "Initial commit"
```

### 5. 关联远程仓库
```bash
git remote add origin https://github.com/你的用户名/仓库名.git
# 或使用SSH
git remote add origin git@github.com:你的用户名/仓库名.git
```

### 6. 推送到GitHub
```bash
# 首次推送
git push -u origin main
# 或者如果默认分支是master
git push -u origin master
```

## 方法二：先创建GitHub仓库再克隆

### 1. 在GitHub上创建新仓库
- 登录 GitHub
- 点击 "New repository"
- 填写信息
- **勾选** "Initialize this repository with a README"
- 点击 "Create repository"

### 2. 克隆到本地
```bash
git clone https://github.com/你的用户名/仓库名.git
cd 仓库名
```

### 3. 添加项目文件
将你的项目文件复制到克隆的目录中

### 4. 提交并推送
```bash
git add .
git commit -m "Add project files"
git push origin main
```

## 常用Git命令

```bash
# 查看状态
git status

# 查看远程仓库
git remote -v

# 拉取最新代码
git pull origin main

# 查看提交历史
git log

# 创建.gitignore文件（忽略不需要提交的文件）
touch .gitignore
```

## .gitignore 示例

```
# 依赖目录
node_modules/
venv/
__pycache__/

# 环境变量
.env
.env.local

# IDE配置
.vscode/
.idea/

# 系统文件
.DS_Store
Thumbs.db

# 构建输出
dist/
build/
*.log
```

## 注意事项

1. **首次推送前**确保已配置Git用户信息：
```bash
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
```

2. **敏感信息**：永远不要提交密码、API密钥等敏感信息

3. **分支命名**：GitHub现在默认使用 `main` 作为主分支，旧仓库可能使用 `master`

4. **SSH vs HTTPS**：
   - HTTPS：每次推送需要输入密码（可使用token）
   - SSH：需要配置SSH密钥，但更方便

## SSH密钥配置（推荐）

```bash
# 生成SSH密钥
ssh-keygen -t ed25519 -C "your_email@example.com"

# 复制公钥
cat ~/.ssh/id_ed25519.pub

# 在GitHub Settings → SSH and GPG keys 中添加
```

## 故障排除

**问题：推送被拒绝**
```bash
# 先拉取远程更改
git pull origin main --rebase
git push origin main
```

**问题：修改最后一次提交**
```bash
git commit --amend -m "新的提交信息"
git push --force origin main  # 谨慎使用
```

# 将新项目提交到GitHub仓库完整指南

## 方法一：从本地项目开始

### 1. 在GitHub上创建新仓库
- 登录 GitHub
- 点击右上角 "+" → "New repository"
- 填写仓库名称和描述
- 选择公开(Public)或私有(Private)
- **不要**初始化 README、.gitignore 或 license（因为本地已有项目）
- 点击 "Create repository"

### 2. 在本地项目初始化Git
```bash
cd /path/to/your/project
git init
```

### 3. 添加文件到暂存区
```bash
git add .
# 或者添加特定文件
git add filename
```

### 4. 提交更改
```bash
git commit -m "Initial commit"
```

### 5. 关联远程仓库
```bash
git remote add origin https://github.com/你的用户名/仓库名.git
# 或使用SSH
git remote add origin git@github.com:你的用户名/仓库名.git
```

### 6. 推送到GitHub
```bash
# 首次推送
git push -u origin main
# 或者如果默认分支是master
git push -u origin master
```

## 方法二：先创建GitHub仓库再克隆

### 1. 在GitHub上创建新仓库
- 登录 GitHub
- 点击 "New repository"
- 填写信息
- **勾选** "Initialize this repository with a README"
- 点击 "Create repository"

### 2. 克隆到本地
```bash
git clone https://github.com/你的用户名/仓库名.git
cd 仓库名
```

### 3. 添加项目文件
将你的项目文件复制到克隆的目录中

### 4. 提交并推送
```bash
git add .
git commit -m "Add project files"
git push origin main
```

## 常用Git命令

```bash
# 查看状态
git status

# 查看远程仓库
git remote -v

# 拉取最新代码
git pull origin main

# 查看提交历史
git log

# 创建.gitignore文件（忽略不需要提交的文件）
touch .gitignore
```

## .gitignore 示例

```
# 依赖目录
node_modules/
venv/
__pycache__/

# 环境变量
.env
.env.local

# IDE配置
.vscode/
.idea/

# 系统文件
.DS_Store
Thumbs.db

# 构建输出
dist/
build/
*.log
```

## 注意事项

1. **首次推送前**确保已配置Git用户信息：
```bash
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
```

2. **敏感信息**：永远不要提交密码、API密钥等敏感信息

3. **分支命名**：GitHub现在默认使用 `main` 作为主分支，旧仓库可能使用 `master`

4. **SSH vs HTTPS**：
   - HTTPS：每次推送需要输入密码（可使用token）
   - SSH：需要配置SSH密钥，但更方便

## SSH密钥配置（推荐）

```bash
# 生成SSH密钥
ssh-keygen -t ed25519 -C "your_email@example.com"

# 复制公钥
cat ~/.ssh/id_ed25519.pub

# 在GitHub Settings → SSH and GPG keys 中添加
```

## 故障排除

**问题：推送被拒绝**
```bash
# 先拉取远程更改
git pull origin main --rebase
git push origin main
```

**问题：修改最后一次提交**
```bash
git commit --amend -m "新的提交信息"
git push --force origin main  # 谨慎使用
```