1. 项目概述在软件开发领域持续集成和持续交付CI/CD已经成为现代工程实践的标配。作为一名长期从事自动化测试开发的工程师我发现很多刚入行的同事在搭建Web UI自动化测试框架时往往卡在如何将本地代码规范地推送到远程Git仓库这一环节。这个看似简单的操作实际上涉及到Git工作流的完整理解和一系列最佳实践的掌握。本教程将带你从零开始使用Python语言构建完整的Web UI自动化测试框架并重点讲解如何将本地代码推送到Git远程仓库这一CI/CD流程中的关键环节。无论你是刚接触自动化测试的新手还是希望优化现有工作流的中级开发者都能从这篇实战指南中获得实用价值。2. 环境准备与工具选型2.1 Python环境配置首先确保你的开发环境已经安装了Python 3.8或更高版本。我推荐使用pyenv或conda来管理Python版本这样可以避免系统Python环境被污染。安装完成后通过以下命令验证python --version pip --version对于Web UI自动化测试我们需要安装几个核心库pip install selenium pytest pytest-html allure-pytest提示建议使用虚拟环境来隔离项目依赖可以使用python -m venv venv创建虚拟环境然后通过source venv/bin/activateLinux/Mac或venv\Scripts\activateWindows激活。2.2 Git安装与基础配置Git是版本控制的核心工具前往 Git官网 下载适合你操作系统的版本。安装完成后需要进行一些基础配置git config --global user.name Your Name git config --global user.email your.emailexample.com git config --global core.autocrlf input # 针对跨平台开发 git config --global core.editor code --wait # 使用VSCode作为默认编辑器验证Git安装git --version3. 初始化Web UI自动化测试项目3.1 项目结构设计一个良好的项目结构是自动化测试框架的基础。以下是我在实践中总结的高效目录结构web-ui-automation/ ├── .gitignore ├── README.md ├── requirements.txt ├── src/ │ ├── pages/ # 页面对象模型 │ ├── tests/ # 测试用例 │ ├── utils/ # 工具函数 │ └── conftest.py # pytest配置 ├── reports/ # 测试报告 └── drivers/ # 浏览器驱动使用以下命令创建项目骨架mkdir -p web-ui-automation/{src/{pages,tests,utils},reports,drivers} touch web-ui-automation/{.gitignore,README.md,requirements.txt}3.2 编写基础测试示例让我们创建一个简单的Web UI测试示例。在src/tests/test_login.py中import pytest from selenium import webdriver from selenium.webdriver.common.by import By pytest.fixture def browser(): driver webdriver.Chrome() yield driver driver.quit() def test_login_success(browser): browser.get(https://example.com/login) browser.find_element(By.ID, username).send_keys(admin) browser.find_element(By.ID, password).send_keys(password123) browser.find_element(By.ID, login-btn).click() assert Dashboard in browser.title这个简单的测试用例验证了登录功能的基本流程。在实际项目中我们会使用Page Object模式来更好地组织代码。4. Git版本控制实践4.1 初始化本地仓库在项目根目录执行git init这会创建一个新的Git仓库。接下来我们需要创建一个合理的.gitignore文件来排除不需要版本控制的文件# Python __pycache__/ *.py[cod] *$py.class *.so .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/ sdist/ var/ wheels/ *.egg-info/ .installed.cfg *.egg # IDE .vscode/ .idea/ *.suo *.ntvs* *.njsproj *.sln *.sw? # Testing reports/ allure-results/ .pytest_cache/ # Environment .env venv/4.2 基础Git工作流将代码添加到暂存区并提交git add . git commit -m Initial commit: setup basic web UI automation framework注意提交信息应当清晰描述变更内容。我推荐使用 Conventional Commits 规范它有助于生成更有意义的变更日志。5. 推送到远程Git仓库5.1 创建远程仓库在GitHub、GitLab或Bitbucket上创建一个新的空仓库。以GitHub为例登录GitHub点击右上角 → New repository输入仓库名称如web-ui-automation选择公开或私有不要初始化README、.gitignore或license文件因为我们已经在本地创建了这些文件5.2 添加远程仓库并推送获取远程仓库URL后在本地执行git remote add origin https://github.com/yourusername/web-ui-automation.git git branch -M main git push -u origin main第一次推送需要认证。推荐使用SSH密钥而不是HTTPS密码生成SSH密钥如果还没有ssh-keygen -t ed25519 -C your.emailexample.com将公钥通常是~/.ssh/id_ed25519.pub添加到GitHub账户的SSH设置中测试连接ssh -T gitgithub.com更新远程URL为SSH格式git remote set-url origin gitgithub.com:yourusername/web-ui-automation.git5.3 分支策略与协作对于团队项目推荐使用Git Flow或类似的分支策略main/master生产就绪代码develop集成分支feature/*功能开发分支hotfix/*紧急修复分支创建并推送新功能分支git checkout -b feature/login-test # 进行一些修改... git add . git commit -m feat: add login test cases git push -u origin feature/login-test6. CI/CD集成准备6.1 添加基础CI配置在项目根目录创建.github/workflows/ci.yml文件name: CI on: push: branches: [ main, develop ] pull_request: branches: [ main, develop ] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - name: Set up Python uses: actions/setup-pythonv2 with: python-version: 3.8 - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt - name: Run tests run: | pytest src/tests --htmlreports/report.html --self-contained-html这个配置会在代码推送到main或develop分支时自动运行测试。6.2 本地开发工作流优化为了确保代码质量建议在本地设置pre-commit钩子。首先安装pre-commitpip install pre-commit然后创建.pre-commit-config.yamlrepos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v4.0.1 hooks: - id: trailing-whitespace - id: end-of-file-fixer - id: check-yaml - id: check-added-large-files - repo: https://github.com/psf/black rev: 22.3.0 hooks: - id: black - repo: https://github.com/PyCQA/flake8 rev: 4.0.1 hooks: - id: flake8安装钩子pre-commit install现在每次提交前都会自动运行代码格式化工具和静态检查。7. 常见问题与解决方案7.1 认证问题问题推送时遇到认证失败错误。解决方案确认使用的是SSH URLgitgithub.com:...而不是HTTPS检查SSH密钥是否正确添加到GitHub账户测试SSH连接ssh -T gitgithub.com7.2 冲突解决问题推送时提示非快进更新。解决方案先拉取远程变更git pull origin main解决冲突后重新提交使用git rebase而不是git merge可以保持历史整洁7.3 大文件处理问题意外提交了大文件现在无法推送。解决方案使用git filter-branch或BFG Repo-Cleaner从历史中删除大文件考虑使用Git LFS管理二进制文件更新.gitignore防止再次提交8. 高级技巧与最佳实践8.1 原子提交将变更分解为逻辑上独立的小提交每个提交只做一件事。例如git add src/pages/login_page.py git commit -m feat: add LoginPage class with basic elements git add src/tests/test_login.py git commit -m test: add login happy path test case8.2 交互式变基使用git rebase -i可以整理提交历史git rebase -i HEAD~5 # 编辑最近5个提交这允许你重新排序提交合并多个提交修改提交信息拆分大提交8.3 钩子自动化除了pre-commit还可以利用Git钩子自动化其他任务。例如在.git/hooks/post-commit中添加#!/bin/sh # 提交后自动运行测试 pytest src/tests -m not slow记得给脚本执行权限chmod x .git/hooks/post-commit8.4 子模块管理如果你的项目依赖其他仓库考虑使用Git子模块git submodule add https://github.com/example/shared-test-utils.git src/utils/shared这可以保持依赖关系清晰同时允许独立更新子模块。9. 完整工作流示例让我们看一个从零开始到推送代码的完整示例创建项目目录并初始化mkdir web-ui-automation cd web-ui-automation git init设置Python环境python -m venv venv source venv/bin/activate # Linux/Mac # venv\Scripts\activate # Windows pip install selenium pytest创建基础文件结构mkdir -p src/{pages,tests,utils} touch src/tests/test_example.py .gitignore README.md编写简单的测试# src/tests/test_example.py def test_example(): assert True配置Gitgit add . git commit -m Initial commit创建远程仓库并推送git remote add origin gitgithub.com:yourusername/web-ui-automation.git git push -u origin main开发新功能git checkout -b feature/new-test # 编写代码... git add . git commit -m feat: add new test case git push -u origin feature/new-test创建Pull Request并合并到main分支。
1. 项目概述在软件开发领域持续集成和持续交付CI/CD已经成为现代工程实践的标配。作为一名长期从事自动化测试开发的工程师我发现很多刚入行的同事在搭建Web UI自动化测试框架时往往卡在如何将本地代码规范地推送到远程Git仓库这一环节。这个看似简单的操作实际上涉及到Git工作流的完整理解和一系列最佳实践的掌握。本教程将带你从零开始使用Python语言构建完整的Web UI自动化测试框架并重点讲解如何将本地代码推送到Git远程仓库这一CI/CD流程中的关键环节。无论你是刚接触自动化测试的新手还是希望优化现有工作流的中级开发者都能从这篇实战指南中获得实用价值。2. 环境准备与工具选型2.1 Python环境配置首先确保你的开发环境已经安装了Python 3.8或更高版本。我推荐使用pyenv或conda来管理Python版本这样可以避免系统Python环境被污染。安装完成后通过以下命令验证python --version pip --version对于Web UI自动化测试我们需要安装几个核心库pip install selenium pytest pytest-html allure-pytest提示建议使用虚拟环境来隔离项目依赖可以使用python -m venv venv创建虚拟环境然后通过source venv/bin/activateLinux/Mac或venv\Scripts\activateWindows激活。2.2 Git安装与基础配置Git是版本控制的核心工具前往 Git官网 下载适合你操作系统的版本。安装完成后需要进行一些基础配置git config --global user.name Your Name git config --global user.email your.emailexample.com git config --global core.autocrlf input # 针对跨平台开发 git config --global core.editor code --wait # 使用VSCode作为默认编辑器验证Git安装git --version3. 初始化Web UI自动化测试项目3.1 项目结构设计一个良好的项目结构是自动化测试框架的基础。以下是我在实践中总结的高效目录结构web-ui-automation/ ├── .gitignore ├── README.md ├── requirements.txt ├── src/ │ ├── pages/ # 页面对象模型 │ ├── tests/ # 测试用例 │ ├── utils/ # 工具函数 │ └── conftest.py # pytest配置 ├── reports/ # 测试报告 └── drivers/ # 浏览器驱动使用以下命令创建项目骨架mkdir -p web-ui-automation/{src/{pages,tests,utils},reports,drivers} touch web-ui-automation/{.gitignore,README.md,requirements.txt}3.2 编写基础测试示例让我们创建一个简单的Web UI测试示例。在src/tests/test_login.py中import pytest from selenium import webdriver from selenium.webdriver.common.by import By pytest.fixture def browser(): driver webdriver.Chrome() yield driver driver.quit() def test_login_success(browser): browser.get(https://example.com/login) browser.find_element(By.ID, username).send_keys(admin) browser.find_element(By.ID, password).send_keys(password123) browser.find_element(By.ID, login-btn).click() assert Dashboard in browser.title这个简单的测试用例验证了登录功能的基本流程。在实际项目中我们会使用Page Object模式来更好地组织代码。4. Git版本控制实践4.1 初始化本地仓库在项目根目录执行git init这会创建一个新的Git仓库。接下来我们需要创建一个合理的.gitignore文件来排除不需要版本控制的文件# Python __pycache__/ *.py[cod] *$py.class *.so .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/ sdist/ var/ wheels/ *.egg-info/ .installed.cfg *.egg # IDE .vscode/ .idea/ *.suo *.ntvs* *.njsproj *.sln *.sw? # Testing reports/ allure-results/ .pytest_cache/ # Environment .env venv/4.2 基础Git工作流将代码添加到暂存区并提交git add . git commit -m Initial commit: setup basic web UI automation framework注意提交信息应当清晰描述变更内容。我推荐使用 Conventional Commits 规范它有助于生成更有意义的变更日志。5. 推送到远程Git仓库5.1 创建远程仓库在GitHub、GitLab或Bitbucket上创建一个新的空仓库。以GitHub为例登录GitHub点击右上角 → New repository输入仓库名称如web-ui-automation选择公开或私有不要初始化README、.gitignore或license文件因为我们已经在本地创建了这些文件5.2 添加远程仓库并推送获取远程仓库URL后在本地执行git remote add origin https://github.com/yourusername/web-ui-automation.git git branch -M main git push -u origin main第一次推送需要认证。推荐使用SSH密钥而不是HTTPS密码生成SSH密钥如果还没有ssh-keygen -t ed25519 -C your.emailexample.com将公钥通常是~/.ssh/id_ed25519.pub添加到GitHub账户的SSH设置中测试连接ssh -T gitgithub.com更新远程URL为SSH格式git remote set-url origin gitgithub.com:yourusername/web-ui-automation.git5.3 分支策略与协作对于团队项目推荐使用Git Flow或类似的分支策略main/master生产就绪代码develop集成分支feature/*功能开发分支hotfix/*紧急修复分支创建并推送新功能分支git checkout -b feature/login-test # 进行一些修改... git add . git commit -m feat: add login test cases git push -u origin feature/login-test6. CI/CD集成准备6.1 添加基础CI配置在项目根目录创建.github/workflows/ci.yml文件name: CI on: push: branches: [ main, develop ] pull_request: branches: [ main, develop ] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - name: Set up Python uses: actions/setup-pythonv2 with: python-version: 3.8 - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt - name: Run tests run: | pytest src/tests --htmlreports/report.html --self-contained-html这个配置会在代码推送到main或develop分支时自动运行测试。6.2 本地开发工作流优化为了确保代码质量建议在本地设置pre-commit钩子。首先安装pre-commitpip install pre-commit然后创建.pre-commit-config.yamlrepos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v4.0.1 hooks: - id: trailing-whitespace - id: end-of-file-fixer - id: check-yaml - id: check-added-large-files - repo: https://github.com/psf/black rev: 22.3.0 hooks: - id: black - repo: https://github.com/PyCQA/flake8 rev: 4.0.1 hooks: - id: flake8安装钩子pre-commit install现在每次提交前都会自动运行代码格式化工具和静态检查。7. 常见问题与解决方案7.1 认证问题问题推送时遇到认证失败错误。解决方案确认使用的是SSH URLgitgithub.com:...而不是HTTPS检查SSH密钥是否正确添加到GitHub账户测试SSH连接ssh -T gitgithub.com7.2 冲突解决问题推送时提示非快进更新。解决方案先拉取远程变更git pull origin main解决冲突后重新提交使用git rebase而不是git merge可以保持历史整洁7.3 大文件处理问题意外提交了大文件现在无法推送。解决方案使用git filter-branch或BFG Repo-Cleaner从历史中删除大文件考虑使用Git LFS管理二进制文件更新.gitignore防止再次提交8. 高级技巧与最佳实践8.1 原子提交将变更分解为逻辑上独立的小提交每个提交只做一件事。例如git add src/pages/login_page.py git commit -m feat: add LoginPage class with basic elements git add src/tests/test_login.py git commit -m test: add login happy path test case8.2 交互式变基使用git rebase -i可以整理提交历史git rebase -i HEAD~5 # 编辑最近5个提交这允许你重新排序提交合并多个提交修改提交信息拆分大提交8.3 钩子自动化除了pre-commit还可以利用Git钩子自动化其他任务。例如在.git/hooks/post-commit中添加#!/bin/sh # 提交后自动运行测试 pytest src/tests -m not slow记得给脚本执行权限chmod x .git/hooks/post-commit8.4 子模块管理如果你的项目依赖其他仓库考虑使用Git子模块git submodule add https://github.com/example/shared-test-utils.git src/utils/shared这可以保持依赖关系清晰同时允许独立更新子模块。9. 完整工作流示例让我们看一个从零开始到推送代码的完整示例创建项目目录并初始化mkdir web-ui-automation cd web-ui-automation git init设置Python环境python -m venv venv source venv/bin/activate # Linux/Mac # venv\Scripts\activate # Windows pip install selenium pytest创建基础文件结构mkdir -p src/{pages,tests,utils} touch src/tests/test_example.py .gitignore README.md编写简单的测试# src/tests/test_example.py def test_example(): assert True配置Gitgit add . git commit -m Initial commit创建远程仓库并推送git remote add origin gitgithub.com:yourusername/web-ui-automation.git git push -u origin main开发新功能git checkout -b feature/new-test # 编写代码... git add . git commit -m feat: add new test case git push -u origin feature/new-test创建Pull Request并合并到main分支。
部署与MNIST手写数字识别)
