一、基础环境配置（Mac 系统）

1. Git 基础配置（首次使用）

# 配置 Git 用户名（替换为你的 GitHub 用户名）
git config --global user.name "你的GitHub用户名"

# 配置 Git 邮箱（替换为你的 GitHub 注册邮箱）
git config --global user.email "你的邮箱@example.com"

2. Python 虚拟环境操作（核心）

# 进入项目根目录（替换为你的项目实际路径）
cd /Users/username/programming/test/PycharmProjects/bing

# 创建 Python 3 虚拟环境（避免 Python 2/3 混淆）
python3 -m venv venv

# 激活虚拟环境（激活后终端前缀显示 (venv)）
source venv/bin/activate

# 退出虚拟环境（如需）
deactivate

# 升级虚拟环境内的 pip（解决版本过低警告）
python -m pip install --upgrade pip

3. 安装项目依赖

# 先创建 requirements.txt（若未创建）
cat > requirements.txt << EOF
pytest>=7.4.0
selenium>=4.15.0
python-dotenv>=1.0.0
webdriver-manager>=4.0.1
EOF

# 安装依赖（激活 venv 后执行）
python -m pip install -r requirements.txt

# 升级已安装的依赖（可选）
pip install --upgrade -r requirements.txt

二、SSH 密钥配置（GitHub 免密推送）

# 生成 SSH 密钥（替换为你的邮箱）
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
# 全程按回车（默认路径+无密码）

# 查看并复制 SSH 公钥（复制输出的整行内容）
cat ~/.ssh/id_ed25519.pub

# 清理 GitHub 旧公钥缓存（解决 host key 变更警告）
ssh-keygen -R github.com

# 验证 SSH 连接（成功提示：Hi 你的用户名! You've successfully authenticated...）
ssh -T git@github.com

三、Git 操作（推送项目到 GitHub）

# 初始化本地 Git 仓库（项目根目录执行）
git init

# 查看已关联的远程仓库
git remote -v

# 删除已关联的远程仓库（如 origin，可选）
git remote rm origin

# 关联 GitHub 远程仓库（SSH 格式，替换为你的仓库地址）
git remote add origin git@github.com:HeliaNephus/python-web-automation-bing.git

# 修改远程仓库地址（从 HTTPS 改为 SSH，核心）
git remote set-url origin git@github.com:HeliaNephus/python-web-automation-bing.git

# 添加所有文件到暂存区（.gitignore 自动忽略冗余文件）
git add .

# 提交暂存区文件（备注清晰的提交信息）
git commit -m "你的项目名称"

# 推送到 GitHub（首次推送加 -u 建立关联）
git push -u origin main

# 后续代码更新后，快速推送
git add .
git commit -m "优化代码：xxx"
git push origin main

四、运行自动化测试

# 激活虚拟环境（必须）
source venv/bin/activate

# 方式1：用 python -m 运行 pytest（最稳妥，避免命令找不到）
python -m pytest test_cases/test_demo.py -v

# 方式2：直接运行 pytest（激活 venv 后推荐）
pytest test_cases/test_demo.py -v

# 方式3：指定虚拟环境内的 pytest 路径（备用）
./venv/bin/pytest test_cases/test_demo.py -v

五、常见问题修复命令

1. Python 2/3 混淆，建议重新创建虚拟环境（指定 Python 3）

# 1. 先退出当前虚拟环境
deactivate

# 2. 删除旧的虚拟环境（避免残留问题）
rm -rf venv

# 3. 用 Python 3 重新创建虚拟环境（指定明确的 python3 路径）
python3 -m venv venv

# 4. 重新激活虚拟环境
source venv/bin/activate

# 5. 此时 pip 已默认是 Python 3 的，直接安装依赖
pip install -r requirements.txt

# 6. 直接运行 pytest
pytest test_cases/test_demo.py -v

2. 重新关联远程github 仓库

# 1. 查看现有远程仓库
git remote -v
# 输出：origin  git@github.com:old/old.git (fetch/push)

# 2. 删除 origin 关联
git remote rm origin

# 3. 验证删除结果
git remote -v
# 无输出，说明删除成功

# 4. （可选）重新关联正确的仓库
git remote add origin git@github.com:new/new.git