198 lines
3.7 KiB
Markdown
198 lines
3.7 KiB
Markdown
# 连接远程 Git 仓库指南
|
||
|
||
## 📋 快速步骤
|
||
|
||
### 情况 1: 本地已有代码，需要连接到远程仓库
|
||
|
||
```bash
|
||
# 1. 初始化 git 仓库（如果还没有）
|
||
git init
|
||
|
||
# 2. 添加远程仓库
|
||
git remote add origin <你的远程仓库URL>
|
||
|
||
# 3. 添加所有文件
|
||
git add .
|
||
|
||
# 4. 创建初始提交
|
||
git commit -m "Initial commit: Add TradingAgents with seeking_alpha_analyst"
|
||
|
||
# 5. 推送到远程（如果是新仓库）
|
||
git branch -M main # 将分支重命名为 main（如果远程使用 main）
|
||
git push -u origin main
|
||
|
||
# 或者如果远程使用 master
|
||
git push -u origin master
|
||
```
|
||
|
||
### 情况 2: 远程仓库已有代码，需要克隆并连接
|
||
|
||
```bash
|
||
# 1. 克隆远程仓库
|
||
git clone <你的远程仓库URL>
|
||
|
||
# 2. 进入目录
|
||
cd <仓库名>
|
||
|
||
# 3. 查看远程仓库
|
||
git remote -v
|
||
```
|
||
|
||
---
|
||
|
||
## 🔗 远程仓库 URL 格式
|
||
|
||
### HTTPS 方式（推荐新手）
|
||
```bash
|
||
git remote add origin https://github.com/username/repo-name.git
|
||
```
|
||
|
||
### SSH 方式（需要配置 SSH key）
|
||
```bash
|
||
git remote add origin git@github.com:username/repo-name.git
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 完整示例
|
||
|
||
假设你的远程仓库是 `https://github.com/yourusername/TradingAgents.git`：
|
||
|
||
```bash
|
||
# 1. 初始化
|
||
git init
|
||
|
||
# 2. 添加远程
|
||
git remote add origin https://github.com/yourusername/TradingAgents.git
|
||
|
||
# 3. 检查远程配置
|
||
git remote -v
|
||
# 应该显示:
|
||
# origin https://github.com/yourusername/TradingAgents.git (fetch)
|
||
# origin https://github.com/yourusername/TradingAgents.git (push)
|
||
|
||
# 4. 添加文件
|
||
git add .
|
||
|
||
# 5. 提交
|
||
git commit -m "Initial commit: TradingAgents with seeking_alpha_analyst"
|
||
|
||
# 6. 推送到远程
|
||
git branch -M main
|
||
git push -u origin main
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 常用命令
|
||
|
||
### 查看远程仓库
|
||
```bash
|
||
git remote -v
|
||
```
|
||
|
||
### 修改远程仓库 URL
|
||
```bash
|
||
git remote set-url origin <新的URL>
|
||
```
|
||
|
||
### 删除远程仓库
|
||
```bash
|
||
git remote remove origin
|
||
```
|
||
|
||
### 重命名远程仓库
|
||
```bash
|
||
git remote rename origin upstream
|
||
```
|
||
|
||
### 拉取远程更新
|
||
```bash
|
||
git pull origin main
|
||
```
|
||
|
||
### 推送本地更新
|
||
```bash
|
||
git push origin main
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 常见问题
|
||
|
||
### 问题 1: 远程仓库已存在内容
|
||
如果远程仓库已经有代码，需要先拉取：
|
||
|
||
```bash
|
||
# 拉取远程代码
|
||
git pull origin main --allow-unrelated-histories
|
||
|
||
# 解决可能的冲突后
|
||
git add .
|
||
git commit -m "Merge remote and local"
|
||
git push origin main
|
||
```
|
||
|
||
### 问题 2: 认证失败
|
||
如果使用 HTTPS，可能需要配置 token：
|
||
|
||
1. GitHub: Settings → Developer settings → Personal access tokens
|
||
2. 生成 token 后，使用 token 作为密码
|
||
|
||
或者配置 SSH key（推荐）：
|
||
```bash
|
||
# 生成 SSH key
|
||
ssh-keygen -t ed25519 -C "your_email@example.com"
|
||
|
||
# 添加到 ssh-agent
|
||
eval "$(ssh-agent -s)"
|
||
ssh-add ~/.ssh/id_ed25519
|
||
|
||
# 复制公钥到 GitHub/GitLab
|
||
cat ~/.ssh/id_ed25519.pub
|
||
```
|
||
|
||
### 问题 3: 分支名称不匹配
|
||
```bash
|
||
# 查看当前分支
|
||
git branch
|
||
|
||
# 重命名分支
|
||
git branch -M main # 重命名为 main
|
||
# 或
|
||
git branch -M master # 重命名为 master
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 使用提供的脚本
|
||
|
||
我已经创建了 `connect_remote_git.sh` 脚本，你可以这样使用：
|
||
|
||
```bash
|
||
# 使用脚本（需要提供远程 URL）
|
||
./connect_remote_git.sh https://github.com/username/repo.git
|
||
|
||
# 或者指定远程名称
|
||
./connect_remote_git.sh https://github.com/username/repo.git origin
|
||
```
|
||
|
||
---
|
||
|
||
## 📌 下一步
|
||
|
||
连接成功后，你可以：
|
||
|
||
1. **继续开发**: 正常使用 `git add`, `git commit`, `git push`
|
||
2. **创建分支**: `git checkout -b feature/new-feature`
|
||
3. **协作**: 其他人可以 `git clone` 你的仓库
|
||
|
||
---
|
||
|
||
## 💡 提示
|
||
|
||
- 首次推送使用 `-u` 参数设置上游分支: `git push -u origin main`
|
||
- 之后可以直接使用 `git push` 和 `git pull`
|
||
- 建议定期提交和推送，避免丢失代码
|
||
|