企业官网建设流程全解析

1. 项目概述：e2e不是缩写游戏，而是软件质量防线的最后一道闸门

“e2e”这三个字母在开发团队的日常沟通里出现频率高得离谱——晨会有人提“这个功能的e2e还没过”，CI流水线失败通知里写着“e2e suite failed at login flow”，运维同学查线上异常时第一句问“e2e监控有没有报错”。但很多人其实没真正拆开看过它：e2e不是某个具体工具的名字，也不是某种神秘配置文件的后缀，它是end-to-end testing（端到端测试）的通用缩写，代表一种以真实用户视角贯穿整个系统链路的验证方式。它不关心你后端用了Spring Boot还是Node.js，也不纠结前端组件是用React还是Vue写的，它只做一件事：模拟一个活生生的人，打开浏览器或启动App，输入账号密码，点击提交按钮，等待页面跳转，检查是否看到“欢迎回来”字样——全程不绕过任何中间层，不mock任何接口，不跳过任何网络请求。这种测试方式天然适配web apps、mobile apps和CLI这三类主流交付形态，也因此成为现代工程化体系中不可替代的质量守门员。如果你正在维护一个用户直接使用的系统，或者你的团队已经把单元测试覆盖率刷到了90%却仍频繁收到线上投诉，那么e2e就是你必须亲手搭起来、调通、并每天盯着它跑的那一套机制。它不适合初学者当入门练习，但对任何想让代码上线后少被半夜电话叫醒的工程师来说，掌握e2e不是加分项，而是生存技能。

2. e2e测试的本质逻辑与设计哲学：为什么不能只靠单元测试和API测试？

2.1 三种测试层级的真实战场分工

很多团队在测试策略上陷入误区，以为“单元测试+API测试=质量闭环”，结果上线后用户反馈“登录页白屏”“支付按钮点了没反应”，而所有API返回都是200，单元测试全部绿灯。问题出在测试视角的断层上。我们用一个真实电商下单流程来对比三者职责：

• 单元测试：验证“计算运费函数”是否在重量>5kg时加收15元附加费。它只管函数内部逻辑，输入是mock数据，输出是return值。它不关心这个运费数字最后有没有显示在页面上，更不关心用户点“确认下单”时页面是否卡死。

• API测试：验证“/api/v1/order/create”接口是否接收了正确的JSON参数，是否返回了包含order_id的201响应，是否在数据库里生成了对应记录。它覆盖了服务端链路，但完全脱离用户交互上下文——它不会知道前端传来的shipping_address字段为空时，页面是否弹出了友好的红色提示框。

• e2e测试：打开Chrome浏览器，访问https://shop.example.com，输入邮箱test@demo.com，输入密码123456，点击“登录”，等待URL变成/dashboard，检查页面顶部是否显示“Hi, test”，然后点击“我的订单”，点击“新建订单”，选择商品A、填写收货地址、点击“提交订单”，等待跳转到/order/success，检查页面是否显示“订单已创建，单号：ORD-2024-XXXXX”。整个过程走的是真实网络、真实渲染引擎、真实设备像素比，中间任何一个环节出错——DNS解析失败、CDN缓存了旧JS、iOS Safari的CSS flex布局bug、甚至Chrome 125刚发布的某个WebDriver兼容性问题——都会让这条e2e用例失败。

提示：e2e不是为了替代单元测试和API测试，而是为了暴露它们共同忽略的“集成缝隙”。这些缝隙往往藏在浏览器渲染引擎与JavaScript运行时的交互细节里、藏在移动端WebView与原生控件的桥接逻辑里、藏在CLI命令执行时环境变量与PATH路径的微妙差异里。

2.2 web apps、mobile apps、CLI三类场景的e2e核心差异点

虽然都叫e2e，但针对不同交付形态，测试驱动方式、环境依赖、断言策略存在本质区别，强行用同一套脚本覆盖三者只会导致维护成本爆炸：

• web apps：核心驱动力是浏览器自动化。主流方案基于WebDriver协议（Selenium、Playwright、Cypress），通过控制真实或无头浏览器实例，操作DOM元素、监听网络请求、截取屏幕快照。关键挑战在于异步等待——页面加载、AJAX响应、React/Vue状态更新都不是同步完成的，传统sleep(2000)写法既不可靠又拖慢整体执行速度。Playwright的自动等待机制（如page.getByRole('button', { name: 'Submit' }).click()会隐式等待按钮可点击）正是为解决此痛点而生。

• mobile apps：核心驱动力是设备/模拟器控制。iOS需Xcode Command Line Tools + WebDriverAgent，Android需ADB + Appium Server。测试脚本不操作HTML，而是操作原生UI控件：driver.findElement(AppiumBy.accessibilityId("login_button")).click()。最大难点在于环境一致性——真机型号碎片化（iPhone 12 vs iPhone 15 Pro Max的屏幕尺寸、安全区域、手势导航）、Android系统版本分叉（Android 12的隐私沙盒 vs Android 14的后台限制）、应用签名调试模式切换，都会导致同一段脚本在不同设备上行为迥异。

• CLI：核心驱动力是进程生命周期管理。没有图形界面，测试对象是标准输入（stdin）、标准输出（stdout）、标准错误（stderr）、退出码（exit code）以及执行过程中产生的文件副作用（如生成config.json）。典型验证逻辑是：const { stdout, stderr, exitCode } = await runCliCommand(['init', '--name=my-app']); expect(exitCode).toBe(0); expect(stdout).toContain('Project initialized successfully'); expect(fs.existsSync('./my-app')).toBe(true);。难点在于环境隔离——CLI命令可能读取全局npm配置、依赖本地$HOME目录下的.cache、甚至修改系统PATH，必须确保每次测试都在干净、可复现的沙箱环境中运行。

2.3 为什么e2e profile1、codex cli、boos cli等热词突然密集出现？

观察近期搜索热词，“e2e profile1”“codex cli”“boos cli”高频共现，这不是偶然。它揭示了一个行业趋势：e2e正从“手写脚本+硬编码配置”的原始阶段，快速演进到“框架即服务（Framework-as-a-Service）”的新范式。过去，一个团队要跑e2e，得自己选Playwright还是Cypress，自己配Docker镜像装Chrome，自己写GitHub Actions YAML定义并发策略，自己维护一套跨平台的mobile device farm。现在，像codex cli这样的工具，本质是一个预置了最佳实践的e2e执行引擎封装：

• codex cli install不只是下载二进制，而是自动检测系统架构（arm64/x64）、自动下载匹配的Chromium/Gecko内核、自动配置headless模式所需的GPU禁用参数；
• codex cli run --profile=profile1中的profile1，是预定义的执行环境模板：它可能指定使用iOS 17.4真机集群、启用Network Throttling模拟3G网络、注入特定的User-Agent字符串用于灰度流量识别；
• codex cli /compact /model /resume这类子命令，则对应e2e执行生命周期的不同切面：/compact压缩测试报告为单HTML文件便于邮件分发，/model调用内置AI模型分析失败截图，自动生成根因推测（如“疑似元素被动态遮罩层覆盖”），/resume支持从中断处续跑，避免因网络抖动导致整套200个用例重跑。

这种CLI驱动的e2e范式，把原本需要资深SRE花三天搭建的基础设施，压缩成一条命令。但代价是：你必须理解profile1背后封装了哪些能力，否则当codex cli run失败时，你连该去查Chrome日志还是Appium日志都不知道。

3. 构建可靠e2e体系的四大支柱：环境、脚本、执行、反馈

3.1 环境准备：拒绝“在我机器上能跑”的玄学

e2e最大的敌人不是代码bug，而是环境漂移（Environment Drift）。我见过最典型的案例：开发在MacBook上用Cypress跑通所有e2e，CI服务器（Linux Ubuntu 22.04）上80%用例失败，排查三天发现是字体渲染差异导致按钮坐标计算偏移2px，而Cypress的click()默认使用坐标点击而非语义点击。环境准备必须遵循“声明式”原则——所有依赖用代码定义，而非口头约定。

• Web环境标准化：

  • 浏览器：明确指定版本，如playwright install chromium@125.0.6422.60，而非playwright install chromium（后者会随Playwright升级自动更新，可能引入不兼容变更）。
  • 屏幕尺寸与DPI：在测试前强制设置，await page.setViewportSize({ width: 1920, height: 1080 });，避免Mac Retina屏与CI服务器普通屏的像素比差异。
  • 网络条件：使用Playwright的page.route()拦截并模拟弱网，await page.route('**/*', route => route.fulfill({ body: 'Simulated slow response', status: 200 }));，比单纯page.waitForTimeout(5000)更可控。

• Mobile环境标准化：

  • 设备抽象层：绝不直接写driver.findElement(By.id("com.example:id/login_btn"))，而是用Page Object Model（POM）封装：“LoginPage.loginButton().click()”。当App UI重构时，只需改POM层，不碰测试用例。
  • 模拟器/真机池管理：使用Firebase Test Lab或AWS Device Farm时，通过--device "model=Nexus6,version=10.0"参数精确指定，避免“任意可用设备”带来的不可预测性。

• CLI环境标准化：

  • 进程沙箱：每个CLI测试用例必须在独立临时目录执行，const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'cli-test-')); process.chdir(tempDir);，防止前一个测试生成的.config文件污染下一个。
  • 依赖隔离：npx是利器，npx codex-cli@1.2.3 init --name=test-app确保每次执行都用指定版本，不依赖全局安装的可能已损坏的版本。

注意：node安装codex cli很慢这类问题，根源常是npm registry源被墙或网络策略限制。解决方案不是换镜像源（可能引入安全风险），而是用codex cli内置的离线安装包：codex cli install --offline ./codex-offline-v1.2.3.tar.gz，该包已预打包所有依赖二进制（Chromium、ADB、WebDriverAgent）。

3.2 脚本编写：从“能跑通”到“易维护”的质变

一个高质量的e2e脚本，其价值80%体现在可维护性上。我曾接手一个200行的Cypress测试文件，里面混着硬编码的XPath、随机生成的测试邮箱、手动计算的等待时间，修改一个登录流程就牵扯17个用例。重构后，核心原则就三条：

• 语义化定位（Semantic Locators）优先：永远不用div:nth-child(3) > button，而用getByRole('button', { name: /submit/i })或getByText('Confirm Order')。Playwright的getByRole系列API基于WAI-ARIA标准，即使UI重构（如把<button>换成<a role="button">），只要语义不变，定位依然有效。

• 数据驱动分离（Data-Driven Separation）：将测试数据（用户名、密码、商品ID）与测试逻辑（登录→加购→结算）彻底解耦。建立test-data/login.valid.json：

  { "email": "valid@test.com", "password": "SecurePass123!", "expectedWelcomeText": "Hi, valid@test.com" }

  测试脚本中通过const data = require('../test-data/login.valid.json');引入，用例失败时一眼看出是数据问题还是逻辑问题。

• 原子化步骤（Atomic Steps）封装：每个业务动作封装为独立函数，且保证幂等性（多次执行效果相同）：

  // 封装登录动作，内部自动处理“已登录则跳过”的逻辑 async function login(page, credentials) { const isLoggedIn = await page.getByText(/Hi,.*@/).isVisible().catch(() => false); if (isLoggedIn) return; await page.goto('/login'); await page.getByLabel('Email').fill(credentials.email); await page.getByLabel('Password').fill(credentials.password); await page.getByRole('button', { name: 'Login' }).click(); await page.waitForURL('/dashboard'); }

3.3 执行策略：平衡速度、稳定与覆盖率的三角难题

e2e执行不是越快越好，也不是越多越好，而是要在可接受的失败率（<1% flaky rate）、可忍受的耗时（<15分钟全量回归）、可验证的覆盖率（核心用户旅程100%覆盖）之间找黄金分割点。

• 分层执行（Tiered Execution）：将e2e用例按风险等级分三层：

  • Smoke（冒烟）：20个最核心路径（登录、首页加载、搜索、下单、支付成功页），每次PR提交必跑，目标耗时<3分钟。
  • Regression（回归）：150个中等重要路径（地址管理、优惠券使用、订单取消），每日凌晨定时跑，目标耗时<10分钟。
  • Exploratory（探索）：50个长尾路径（多语言切换、深色模式、离线缓存），每周跑一次，目标耗时<20分钟。

• 智能重试（Intelligent Retry）：对已知的偶发性失败（如网络超时、元素短暂不可见），启用有限重试。Playwright支持test.use({ retriess: 2 });，但必须配合精准的失败原因判断——只对TimeoutError重试，对AssertionError（断言失败）绝不重试，否则会掩盖真实bug。

• 并行化（Parallelization）：Playwright原生支持npx playwright test --workers=4，但并行数不是越多越好。实测表明，在16核CPU服务器上，--workers=6比--workers=12总耗时更短，因为过多worker会加剧CPU和磁盘IO竞争，导致单个浏览器实例启动变慢。

3.4 反馈闭环：让e2e失败真正驱动改进

e2e失败通知如果只是发一封“Test XYZ failed”的邮件，那它就是噪音。真正的反馈闭环必须回答三个问题：哪里失败？为什么失败？怎么修复？

• 精准失败定位：Playwright的trace功能是神器。开启npx playwright test --trace on，失败后生成.zip追踪文件，用npx playwright show-trace trace.zip打开可视化面板，可逐帧回放鼠标移动、网络请求、DOM变化，甚至看到失败瞬间的完整堆栈和console.error。

• 根因自动归类：结合codex cli /model命令，对失败截图和日志进行AI分析。例如，当page.getByText('Order Confirmed').isVisible()失败时，AI模型可能输出：“检测到页面存在遮罩层

  ，建议添加await page.locator('.loading-overlay').isHidden();”。

• 修复引导（Fix Guidance）：在CI失败报告中，直接给出可点击的修复链接。例如，指向Confluence文档《e2e常见flaky模式及修复方案》，其中第3.2节详细说明：“当getByRole('button').click()失败时，优先检查元素是否被动态插入的广告Banner遮挡，解决方案：await page.locator('div[aria-label="Advertisement"]').waitFor({ state: 'hidden', timeout: 5000 });”。

4. 实操详解：从零搭建一个跨平台e2e流水线（web + mobile + CLI）

4.1 初始化项目结构：告别杂乱无章的脚本仓库

一个健壮的e2e项目，目录结构必须清晰反映“环境-脚本-数据-配置”的分离原则。我推荐以下结构（已用于5个以上生产项目）：

e2e/ ├── config/ # 全局配置 │ ├── base.config.ts # Playwright基础配置（超时、重试） │ ├── web.config.ts # Web专用配置（浏览器类型、viewport） │ ├── mobile.config.ts # Mobile专用配置（设备名称、app路径） │ └── cli.config.ts # CLI专用配置（临时目录路径、超时阈值） ├── fixtures/ # 测试夹具（登录态、API Token） │ └── authenticated-user.ts ├── pages/ # Page Object Model │ ├── web/ │ │ ├── LoginPage.ts │ │ └── DashboardPage.ts │ ├── mobile/ │ │ ├── LoginScreen.ts │ │ └── HomeScreen.ts │ └── cli/ │ └── InitCommand.ts ├── specs/ # 测试用例 │ ├── web/ │ │ ├── login.spec.ts # 登录流程e2e │ │ └── checkout.spec.ts # 下单流程e2e │ ├── mobile/ │ │ └── login.spec.ts │ └── cli/ │ └── init.spec.ts ├── test-data/ # 测试数据 │ ├── login.valid.json │ └── login.invalid.json ├── utils/ # 工具函数 │ ├── screenshot.ts # 统一截图命名规则 │ └── retry.ts # 自定义重试逻辑 └── package.json # 依赖声明（playwright, @playwright/test, appium-webdriveragent）

实操心得：pages/目录下的每个Page类，必须导出一个静态create方法，接受page或driver实例作为参数，返回该Page的实例。这样在测试用例中可写const loginPage = LoginPage.create(page);，避免在构造函数中做异步初始化（如await page.goto()），保证Page类纯粹性。

4.2 Web端e2e：用Playwright实现“所见即所测”

以登录流程为例，展示如何写出稳定、可读、可维护的脚本：

// specs/web/login.spec.ts import { test, expect } from '@playwright/test'; import { LoginPage } from '../../pages/web/LoginPage'; import validLoginData from '../../test-data/login.valid.json'; test.describe('Web Login Flow', () => { test('should login successfully with valid credentials', async ({ page }) => { // 1. 创建Page实例，封装所有DOM操作 const loginPage = LoginPage.create(page); // 2. 执行登录动作（内部已处理重定向、等待等细节） await loginPage.performLogin(validLoginData); // 3. 断言：检查URL和页面文本，不依赖具体DOM结构 await expect(page).toHaveURL(/\/dashboard/); await expect(page.getByText(new RegExp(`Hi, ${validLoginData.email}`))).toBeVisible(); // 4. 清理：退出登录，为下一个用例准备干净状态 await loginPage.logout(); }); });

对应的LoginPage.ts实现：

// pages/web/LoginPage.ts import { Page } from '@playwright/test'; export class LoginPage { private readonly emailInput = this.page.getByLabel('Email'); private readonly passwordInput = this.page.getByLabel('Password'); private readonly loginButton = this.page.getByRole('button', { name: 'Login' }); private readonly welcomeText = this.page.getByText(/Hi,.+@/); private readonly logoutButton = this.page.getByRole('button', { name: 'Logout' }); constructor(private readonly page: Page) {} static create(page: Page): LoginPage { return new LoginPage(page); } async performLogin(credentials: { email: string; password: string }) { // 自动处理“已在登录态”的情况 const isAlreadyLoggedIn = await this.welcomeText.isVisible().catch(() => false); if (isAlreadyLoggedIn) return; await this.page.goto('/login'); // 使用fill而非type，避免触发不必要的输入事件 await this.emailInput.fill(credentials.email); await this.passwordInput.fill(credentials.password); // Playwright自动等待按钮可点击（enabled & visible & not obscured） await this.loginButton.click(); // 等待关键导航完成，比waitForTimeout更可靠 await this.page.waitForURL('/dashboard', { waitUntil: 'networkidle' }); } async logout() { if (await this.logoutButton.isVisible().catch(() => false)) { await this.logoutButton.click(); await this.page.waitForURL('/login'); } } }

4.3 Mobile端e2e：用Appium + WebdriverIO打通iOS/Android双端

Mobile e2e的核心挑战是设备控制协议的统一。Appium作为中间层，向上提供WebDriver API，向下对接iOS的XCUITest和Android的UiAutomator2。为降低复杂度，我们选用WebdriverIO（比原生Appium Client更简洁）：

// specs/mobile/login.spec.ts import { remote } from 'webdriverio'; import { LoginScreen } from '../../pages/mobile/LoginScreen'; // 从config/mobile.config.ts读取设备配置 const config = require('../../config/mobile.config'); test.describe('Mobile Login Flow', () => { let driver; let loginScreen; test.beforeAll(async () => { // 启动Appium会话 driver = await remote({ ...config, capabilities: { platformName: 'iOS', deviceName: 'iPhone 14', app: '/path/to/app.ipa', automationName: 'XCUITest', noReset: true, // 保留App数据，加速启动 } }); loginScreen = LoginScreen.create(driver); }); test('should login successfully on iOS', async () => { await loginScreen.enterEmail('valid@test.com'); await loginScreen.enterPassword('SecurePass123!'); await loginScreen.tapLoginButton(); // 使用Appium的native context断言 await expect(driver).toHaveText('Dashboard', { timeout: 10000 }); }); test.afterAll(async () => { await driver.deleteSession(); }); });

LoginScreen.ts封装设备无关操作：

// pages/mobile/LoginScreen.ts import { WebDriver } from 'webdriverio'; export class LoginScreen { private readonly emailField = '~email_field'; private readonly passwordField = '~password_field'; private readonly loginButton = '~login_button'; constructor(private readonly driver: WebDriver) {} static create(driver: WebDriver): LoginScreen { return new LoginScreen(driver); } async enterEmail(email: string) { // 使用accessibility id定位，iOS/Android通用 await this.driver.$(this.emailField).setValue(email); } async enterPassword(password: string) { await this.driver.$(this.passwordField).setValue(password); } async tapLoginButton() { await this.driver.$(this.loginButton).click(); // 等待原生导航完成 await this.driver.pause(2000); } }

4.4 CLI端e2e：用Jest + execa构建进程级验证

CLI测试的关键是捕获进程的完整生命周期。execa库是最佳选择，它能精确控制stdin/stdout/stderr，并返回Promise：

// specs/cli/init.spec.ts import { execa } from 'execa'; import * as fs from 'fs/promises'; import { InitCommand } from '../../pages/cli/InitCommand'; test.describe('CLI Init Command', () => { test('should create project directory with correct files', async () => { const projectName = 'test-cli-project'; const tempDir = await fs.mkdtemp('/tmp/cli-test-'); try { // 在临时目录执行init命令 const result = await execa( 'npx', ['codex-cli@1.2.3', 'init', '--name', projectName], { cwd: tempDir, timeout: 30000 // 30秒超时，防卡死 } ); // 验证退出码 expect(result.exitCode).toBe(0); // 验证stdout输出 expect(result.stdout).toContain('Project initialized successfully'); // 验证文件系统副作用 const projectPath = `${tempDir}/${projectName}`; expect(await fs.access(projectPath)).resolves.not.toThrow(); expect(await fs.access(`${projectPath}/package.json`)).resolves.not.toThrow(); expect(await fs.access(`${projectPath}/README.md`)).resolves.not.toThrow(); } finally { // 清理临时目录 await fs.rm(tempDir, { recursive: true, force: true }); } }); });

InitCommand.ts封装常用CLI操作：

// pages/cli/InitCommand.ts import { execa } from 'execa'; export class InitCommand { static async run(name: string, options: { cwd?: string } = {}) { return execa('npx', ['codex-cli', 'init', '--name', name], { cwd: options.cwd, timeout: 30000 }); } }

5. 常见问题与排查技巧实录：那些让你抓狂的e2e失败现场

5.1 Web端经典问题：元素找不到（Element Not Found）的10种真相

e2e脚本里最常抛出的错误是TimeoutError: element not found，但背后原因千差万别。以下是我在5年e2e维护中总结的TOP10根因及排查路径：

实操心得：遇到Element Not Found，第一步永远不是改定位器，而是执行await page.screenshot({ path: 'debug-before.png' });，然后在失败后立即再截一张debug-after.png，对比两张图，90%的问题肉眼可见。

5.2 Mobile端高频陷阱：真机与模拟器的“信任危机”

Mobile e2e在模拟器上100%通过，真机上50%失败，这是常态。根本原因是模拟器是理想化的软件环境，而真机充满物理世界的不确定性：

• iOS真机证书问题：WebDriverAgent在真机上运行需开发者证书签名。xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=<UDID>' test失败时，90%是证书问题。解决方案：在Xcode中打开WebDriverAgent项目，选择Team，勾选Automatically manage signing，Clean Build Folder后重试。

• Android真机USB调试不稳定：adb devices显示设备，但Appium无法连接。实测有效方案：adb kill-server && adb start-server && adb devices，并确保USB线是数据线（非充电线），手机开启“开发者选项”中的“USB调试（安全设置）”。

• 元素定位失效：模拟器用id=com.example:id/login_btn能定位，真机上id变成com.example.debug:id/login_btn（包名带.debug后缀）。解决方案：在Appium Capability中设置appPackage: 'com.example'，并用driver.findElement(MobileBy.id('login_btn'))，Appium会自动处理包名前缀。

5.3 CLI端隐蔽雷区：环境变量与PATH的“无声篡改”

CLI测试最诡异的失败，往往源于环境变量的“静默污染”：

• 全局npm配置干扰：npm config get registry返回https://registry.npmjs.org/，但CI服务器上npm config list显示prefix = "/usr/local"，导致npx命令从全局/usr/local/bin找cli，而非项目node_modules/.bin。解决方案：在测试脚本开头强制process.env.PATH = path.join(process.cwd(), 'node_modules', '.bin') + ':' + process.env.PATH;。

• Home目录缓存冲突：CLI命令读取~/.config/my-cli/config.json，而多个测试用例共享同一HOME，导致状态污染。解决方案：测试前process.env.HOME = await fs.mkdtemp('/tmp/home-');，测试后rm -rf $HOME。

• 信号中断（Signal Interrupt）：CLI命令执行中被SIGINT（Ctrl+C）中断，但测试框架未捕获，导致进程残留。解决方案：execa的reject选项设为false，手动检查result.signal是否为SIGINT，并执行kill -9清理子进程。

5.4 “删除codex cli指令”与“安装很慢”的终极解法

关于热词中高频出现的删除codex cli指令和node安装codex cli很慢，本质是工具链治理问题：

• 删除指令：npm uninstall -g codex-cli有时无法彻底清除，因为codex-cli可能在安装时注册了shell completion脚本（如/etc/bash_completion.d/codex）或systemd服务。安全删除步骤：

  1. npm uninstall -g codex-cli
  2. which codex查看二进制路径，手动rm该文件
  3. grep -r "codex" ~/.bashrc ~/.zshrc /etc/bash_completion.d/删除相关行
  4. rm -rf ~/.codex-cache/（其私有缓存目录）

• 安装慢：根本原因是codex-cli安装时需下载数百MB的Chromium二进制。官方提供的--offline模式是唯一可靠方案：

  # 1. 在网络良好的机器上下载离线包 codex cli install --offline --output codex-offline.tar.gz # 2. 将codex-offline.tar.gz拷贝到目标机器 # 3. 离线安装（全程不联网） codex cli install --offline ./codex-offline.tar.gz

最后分享一个小技巧：在CI环境中，永远用codex cli install --version 1.2.3 --offline指定版本和离线模式，而不是latest。我曾因latest自动升级到1.3.0，其内置Chromium版本与CI服务器内核不兼容，导致所有e2e用例在page.goto()时崩溃，排查耗时8小时。稳定压倒一切。