尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

Codex 配 TaoToken:逐项解读 create-vite 的 Vue 3 交互选项

Codex 配 TaoToken:逐项解读 create-vite 的 Vue 3 交互选项 用pnpm create vuelatest创建 Vue 3 项目时终端会连续抛出 TypeScript、JSX、Vue Router、Pinia、Vitest、ESLint、Prettier 等十个交互选项新手很容易在要不要开启上犹豫。我的解决办法是先把 Codex 的模型通道接到 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end让它帮我逐项解读 create-vite 每个开关的含义再生成一条适合自己项目的创建指令。TaoToken 在这里只负责给 Codex 提供稳定的 API 通道和 Key真正的选项判断、命令生成全部由 Codex 结合 Vue 3 项目经验完成。整个过程不用反复切工具也不用对着终端猜答案。1. create-vite 十连问之前先把 Codex 接到 TaoToken1.1 在 ~/.codex/config.toml 里注册 TaoToken 供应商先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key把生成的密钥复制下来。接着找到 Codex 的配置文件~/.codex/config.toml把 provider 配置追加进去model YOUR_MODEL_ID [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后在 shell 配置文件~/.zshrc或~/.bashrc里导出真实 Keyexport TAOTOKEN_API_KEYYOUR_API_KEY有两个细节容易出错base_url填https://taotoken.net/api末尾不要加/v1model字段不要靠记忆填版本号先到 TaoToken 模型广场复制当前可用的模型 ID 再写进去。TaoToken 扮演的是统一 API 兼容通道Codex 经由这个 provider 与它通信后续 create-vite 的选项解读才能正常返回。1.2 让 Codex 先逐项解释 create-vite 的交互选项配置完 provider 后重启终端进入准备创建项目的目录执行codex命令开一个会话把下面这段提示词贴进去我要用 pnpm create vuelatest 创建 Vue 3 项目。这个命令会交互式询问项目名称、是否开启 TypeScript、是否启用 JSX、是否引入 Vue Router、是否引入 Pinia、是否引入 Vitest、是否引入端到端测试工具、是否引入 ESLint、是否引入 Prettier、是否引入 Vue DevTools 7 扩展。请你逐项解释它们各自的作用适合什么场景不开会有什么影响。Codex 走的是 TaoToken 提供的通道返回的内容会落在 create-vite 这个具体工具上而不是泛泛而谈的 Vue 概念。如果不想逐条读文字可以直接让它给出一张决策表再按表里的组合决定自己的选择。这一步把十道选择题变成了一次有依据的决策比对着终端发懵要快很多。2. 十个交互选项的决策表与创建指令生成2.1 create-vite 选项解读表Codex 对各项开关的解释可以汇总成下面这张表。这里不照抄官方文档而是按 Vue 3 项目常见的业务场景来写方便你对照自己的情况做选择。交互项Codex 的解读建议项目名称同时作为目录名和 package.json 的 name 字段用短横线命名例如 vue-projectTypeScript生成 .ts 文件和 tsconfig.json提供类型检查团队熟悉就开不熟可以暂缓JSX允许在 Vue 组件里用 JSX 语法描述渲染纯 Vue 项目不需要习惯 React 语法可开Vue Router生成 src/router/index.ts 和 views 目录提供路由能力多页面项目建议开Pinia生成 src/stores/counter.ts启用状态管理有跨组件共享状态就开Vitest生成 vitest.config.ts对接单元测试打算写单测才开端到端测试引入 Playwright 等 E2E 测试框架前期可以先不开ESLint生成 ESLint 配置配合编辑器做语法检查建议开Prettier生成格式化配置提供 format 脚本建议开Vue DevTools 7内置调试面板运行时可按 AltShiftD 打开建议开这套组合没有绝对标准。原文作者的习惯是除了测试相关的那两项其他都开TypeScript、ESLint、Prettier 管代码规范JSX、Vue Router、Pinia 覆盖大多数业务需求Vue DevTools 7 免去安装浏览器扩展。我的建议是这是第一个 Vue 3 项目的时候就按这个组合走等遇到实际测试需求再补 Vitest 和端到端测试也不迟后面手动安装并不会比脚手架生成复杂多少。2.2 按偏好让 Codex 生成完整创建命令把需求描述得越具体Codex 给出的执行序列就越接近原文的流程。例如按以下偏好生成 pnpm create vuelatest 的完整操作序列项目名 vue-projectTypeScript 开启JSX 不开启Vue Router 开启Pinia 开启Vitest 不开启端到端测试不开启ESLint 开启Prettier 开启Vue DevTools 7 开启。同时给出后续启动命令。Codex 会返回每一步按 y 还是按 n并把cd vue-project、pnpm install、pnpm format、pnpm dev一起列出来。这里必须说清楚Codex 只是生成命令序列真正在你本地终端执行这些命令的还是你自己。原文里也专门提到pnpm format只在选择了 Prettier 时才存在因为这条命令来自 package.json 里的 format script所以让 Codex 读取 package.json 再解释命令比让它凭记忆推断更准确。3. 启动、打包与目录结构3.1 pnpm format、pnpm dev、pnpm build 的关系create-vite 的交互式询问结束只是完成了项目结构初始化离跑起来还有几步。原文连续执行了pnpm install、pnpm format、pnpm dev这些命令之间的关系可以继续让 Codex 对照 package.json 解释。在 Codex 会话里追问请结合当前项目的 package.json 的 scripts 字段解释 pnpm format、pnpm dev、pnpm build 的执行过程和产物位置。Codex 会告诉你pnpm format实际执行prettier --write src/它会直接改写 src 目录下的文件格式所以适合在改代码前先跑一次让整个目录风格统一pnpm dev启动 Vite 开发服务器默认监听 http://localhost:5173配合 Vue DevTools 7 可以直接在页面里调试组件状态pnpm build执行 Vue 的生产构建把产物输出到./dist目录部署时把 dist 内容放上服务器即可。实际执行编译构建必须在你自己的机器上完成Codex 负责解释和生成命令不碰你的终端环境。3.2 让 Codex 带着你读 src 目录结构create-vite 生成的工程里src 下的每个目录对应一个职责。把下面这段发给 Codex请解释 src/router/index.ts、src/stores/counter.ts、src/views、src/components、src/App.vue、src/main.ts、src/env.d.ts 在 Vue 3 项目里的作用。Codex 会按入口、路由、状态、视图、组件几个层次拆开讲main.ts负责创建应用实例并把 router 和 pinia 挂上去App.vue是最外层根组件通常只放路由出口views下的文件与路由一一对应HomeView.vue、AboutView.vue 就是 router/index.ts 里 routes 数组引用的页面组件components存放业务组件stores/counter.ts用 defineStore 定义 Pinia 仓库env.d.ts是 Vite 环境变量的类型声明文件。让 Codex 讲完这一串再回头看目录树会比单纯背结构清晰很多。原文说接下来还会对目录结构展开说明实际上你自己用 Codex 也能完成同样的事而且可以针对自己生成的项目逐文件追问。4. VSCode 开发前准备Vue Official 与 Vetur 的冲突4.1 用 Codex 生成插件安装与冲突检查清单原文在项目跑起来后做了两件事装 Vue Official原 Volar扩展、检查 Vetur 是否禁用。这一块不用自己翻插件市场直接让 Codex 列检查清单我在用 VSCode 开发 Vue 3 项目。请列出必须安装的扩展、必须禁用的扩展、建议安装的扩展并解释 Vue Official 与 Vetur 为什么不能在 Vue 3 项目里共存。Codex 会给出类似这样的分组必须安装 Vue OfficialVue 2 项目才需要 VeturVue 3 项目要在工作区禁用建议安装 Auto Close Tag、Auto Rename Tag、indent-rainbow、Path Intellisense、TODO Highlight、ESLint、Prettier 等。两个语言服务同时监听 .vue 文件时会出现补全重复、格式化冲突所以项目里只能保留一个。对同时维护 Vue 2 和 Vue 3 仓库的人来说最省事的做法是在每个工作区里单独禁用对方插件比全局卸载要灵活。4.2 ref.value 自动补全设置Vue Official 的设置里有一项Vue Auto Insert: Dot Value打开后在 script 里输入 ref 变量名时会自动补出.value例如输入 count 后自动变成 count.value。Codex 给出的建议是如果你经常写 ref 却不写 .value就在 VSCode 设置里把 Auto Insert 打开如果模板里大量使用 ref开启后可以减少一次手动输入。注意这个设置需要你手动在 VSCode 设置面板里勾选或者把配置写进工作区的 settings.jsonCodex 只能生成参考片段不能直接改动你本机的编辑器配置。5. 验证 Codex 通道与排障5.1 两条验证路径配置完成后的第一件事不是马上创建项目而是先确认 Codex 每次调用是否真的经过 TaoToken 的 API 通道以及是否产生了用量记录。在 Codex 会话里输入请告诉我当前使用的模型提供方名称和模型 ID。如果 Codex 能答出 provider 是 taotoken 以及你在 config.toml 里填的模型 ID说明通道已经通。另一条路径是登录 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end在控制台里查看刚才那次对话是否有调用记录。我的做法是创建 Key 之后先在官网控制台发一次测试请求再回到 Codex 跑一次正式对话两边记录能对上就说明配置干净了。5.2 最容易出现的三个配置错误第一base_url写成https://taotoken.net/api/v1。TaoToken 的 Base URL 就是https://taotoken.net/api末尾不需要补/v1多写一段会让请求路径错误Codex 会抛出 404。第二shell 里的TAOTOKEN_API_KEY还带着YOUR_API_KEY占位符没有替换成官网创建的真实 KeyCodex 返回 401。第三model字段填了一个自己猜的版本号。模型 ID 要以模型广场展示的为准先打开官网复制当前可用的模型 ID 再填进 config.toml猜版本号会造成模型不存在或行为异常。这三类错都发生在配置阶段和 create-vite 本身无关排查时按 base_url、环境变量、model 字段的顺序过一遍即可。如果你正准备创建 Vue 3 项目又不想在 create-vite 的十个交互选项上反复犹豫建议先把 Codex 的通道切到 TaoToken打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册、创建 API Key完成一次对话后回控制台确认用量再正式跑pnpm create vuelatest。这样后面每一步的选项判断都可以继续交给 Codex 帮你把住。
返回列表