VSCode 安卓开发 flutter doctor 不过？TaoToken 只供 Key，Codex 这样查环境变量

VSCode 做安卓开发flutter doctor不过、环境变量改了终端不认、插件冲突把调试项顶掉这三类排障最磨人。这次用 TaoToken 给 Codex 供一把 Key 和一个 Base URL先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key再让 Codex 对照flutter doctor -v输出、PATH/JAVA_HOME/ANDROID_HOME 和.vscode/launch.json里的 Flutter 调试项逐项查。注意TaoToken 只负责给 Codex 供 Key 和 Base URL不替你装 Flutter SDK也不替你改 PATH。你装完 Flutter SDK、Android SDK执行flutter doctor看到红叉或叹号先把 Codex 的通道配好再把输出贴回去比反复卸载重装 SDK 省时间。1. flutter doctor 飘红时先把 Codex 的通道配好1.1 为什么先配 Codex 而不是反复重装 Flutter SDKFlutter 环境搭建的步骤本身不复杂解压 Flutter SDK 到C:\src\flutter把C:\src\flutter\bin追加进 PATH装 Android SDK 或 Android Studio最后跑flutter doctor。但真正卡人的地方在“部分成功”的状态Flutter 命令能跑flutter doctor却提示Android toolchain有问题或者cmdline-tools component is missing又或者Unable to locate Android SDK。这时候如果直接按某些旧教程重装很容易把 PATH 越改越乱。更稳的做法是先把 Codex 接到 TaoToken 的兼容通道上让 Codex 帮你读报错、对照变量。TaoToken 在这里只做一件事给 Codex 供 Key 和 Base URL。它不碰你的 Flutter SDK也不碰你的 Android SDK更不会自动改系统环境变量。你需要在本地终端执行诊断命令把输出贴进 Codex 对话让它解释每一项的含义再给你一份“在本地执行”的修复顺序。准备材料很短一个 TaoToken API Key占位符写作YOUR_API_KEY。Codex 的配置文件~/.codex/config.toml。你的flutter doctor -v输出。PATH、JAVA_HOME、ANDROID_HOME 当前值。.vscode/launch.json里 Flutter 调试项的内容。Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建。不要拿官网带 UTM 的地址去填 Base URL那会报错。1.2 在 TaoToken 创建 Key填进 ~/.codex/config.toml先打开 TaoToken 注册进控制台创建 API Key。复制出来的 Key 只放在本地环境变量或 Codex 配置里不要贴进截图、日志或提交到 Git。然后确认 Codex 的配置文件位置Windows 一般是C:\Users\你的用户名\.codex\config.tomlmacOS/Linux 是~/.codex/config.toml。这个文件如果不存在手动新建。Codex 的配置要写model_provider和base_url不要把 Claude Code 的ANTHROPIC_*变量套到 Codex 上。一个可复制的起点如下# ~/.codex/config.toml model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY这里有两个点必须盯住。第一base_url填https://taotoken.net/api末尾不要加/v1也不要加官网落地页的 UTM 参数。第二model不要凭记忆写一个带日期后缀的 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准把对应模型 ID 原样填进去。然后设置环境变量。Windows PowerShellsetx TAOTOKEN_API_KEY YOUR_API_KEYmacOS 或 Linuxexport TAOTOKEN_API_KEYYOUR_API_KEYsetx只影响新开的终端。设置完关掉所有 VSCode 窗口重新打开一个 PowerShell 或终端再启动 Codex。如果你只在当前终端exportCodex 从别的入口启动时可能读不到建议写进 shell 的启动文件例如~/.zshrc或~/.bashrc再source一次。2. 把 flutter doctor -v 输出丢给 Codex对照三种路线查环境变量2.1 Flutter 路线的 PATH、ANDROID_HOME、JAVA_HOMEflutter doctor不带-v时信息太少排障阶段直接上flutter doctor -v输出里常见这几类Android toolchain - develop for Android devices后面跟着cmdline-tools component is missing。Unable to locate Android SDK但 Android Studio 明明装了。Java binary at ...版本不对或者JAVA_HOME指向了旧 JDK。Android license status unknown需要单独跑flutter doctor --android-licenses。把这些输出整段复制给 Codex不要只发“flutter doctor 不过”这一句。让 Codex 逐行解释每一项属于哪条路线Flutter 自身、Android SDK、Java/Kotlin 工具链还是 VSCode 插件。然后把你当前的环境变量贴给它echo $env:PATH echo $env:JAVA_HOME echo $env:ANDROID_HOMEFlutter 路线最常出问题的是 PATH 里C:\src\flutter\bin没进去或者进了但排在旧 Flutter 路径后面。ANDROID_HOME应该指向 Android SDK 根目录例如C:\Users\%USERNAME%\AppData\Local\Android\Sdk。JAVA_HOME指向 JDK 根目录例如C:\Program Files\Java\jdk-17。Codex 可以帮你对照flutter doctor -v里的实际检测路径指出哪个变量和实际安装位置不一致但修改系统环境变量这一步必须由你在本地完成。改完后不要在同一个终端里反复echo就以为生效了。新开一个终端再让 Codex 根据新输出判断。Codex 只能看到你贴给它的文本它不能直接连你的机器去读注册表或改 PATH这一点先讲清楚后面沟通会顺很多。2.2 React Native 与 Java/Kotlin 路线容易混淆的变量原文把 VSCode 安卓开发分成了 Flutter、React Native、Java/Kotlin 三条主要路线。排障时最怕把三条路线的环境变量混在一起。Flutter 项目不一定需要GRADLE_HOME但 Java/Kotlin 原生项目经常需要React Native 依赖 Node、Android SDK、platform-tools还把emulator和tools加进 PATH。你如果同时装了 React Native CLI 和 Flutter终端里adb、emulator、java可能来自不同目录。可以把三条路线的最小子集写成一张对照表贴给 Codex 让它检查你有没有漏项路线关键变量常见检查命令FlutterPATH 含flutter\bin、ANDROID_HOME、JAVA_HOMEflutter doctor -vReact NativeANDROID_HOME、PATH 含platform-tools、emulatornpx react-native doctor、adb devicesJava/KotlinJAVA_HOME、ANDROID_HOME、GRADLE_HOME、PATH 含%JAVA_HOME%\binjava -version、javac -version、./gradlew -vCodex 会根据你贴的flutter doctor -v和变量值指出“Android toolchain 报错”到底是因为 SDK 路径没配还是因为cmdline-tools没装。它也可以生成sdkmanager的命令模板例如列出已安装和可安装的包sdkmanager --list但执行必须在本地终端装cmdline-tools、接受 license 也是你在本地做。不要把“让 Codex 直接修环境”当成一步它没这个权限也不应该有。3. 环境变量改了 VSCode 还不生效重载窗口与终端 shell 检查3.1 Developer: Reload Window 的正确姿势环境变量改对之后flutter doctor在系统终端里过了但 VSCode 里的集成终端还是报旧路径。原文在常见问题里提过“在 VSCode 中重新加载环境”操作是CtrlShiftP输入Developer: Reload Window。这一步不是玄学VSCode 启动时会把环境变量快照传给扩展和终端系统变量后改旧窗口不会自动刷新。但Reload Window只重载窗口不保证重载操作系统给 VSCode 进程的环境。更稳的顺序是在系统环境变量里改完 PATH/JAVA_HOME/ANDROID_HOME。关闭所有 VSCode 窗口。新开一个 PowerShell 或终端确认echo $env:JAVA_HOME和flutter doctor -v正常。从同一个终端执行code启动 VSCode。在 VSCode 里再执行一次Developer: Reload Window。如果你用的是 Windowssetx之后旧终端不会更新必须新开终端。Codex 可以帮你判断“是 VSCode 没重载还是终端 shell 不对”但重载动作要你点。3.2 检查集成终端默认 shell 与 setx 后的新会话VSCode 集成终端可能默认用 PowerShell、cmd 或 Git Bash。不同 shell 读环境变量的方式不同。Windows PowerShell 看echo $env:PATH echo $env:ANDROID_HOMEcmd 看echo %PATH% echo %ANDROID_HOME%Git Bash 看echo $PATH echo $ANDROID_HOME如果你在系统变量里配了但 Git Bash 不认可能是 Git Bash 有自己的启动脚本覆盖了 PATH。把Ctrl,打开设置搜索terminal.integrated.defaultProfile.windows确认默认 shell 是哪一个。让 Codex 根据你贴的 shell 类型和输出给一份“在该 shell 里临时验证”的命令例如在 Git Bash 里临时导出export ANDROID_HOME/c/Users/$USER/AppData/Local/Android/Sdk export PATH$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator临时导出只用于验证路径是否正确。验证通过后仍然建议回到系统环境变量里做永久配置避免每次开终端都手动 export。4. .vscode/launch.json 里 Flutter 调试项被插件冲突覆盖怎么办4.1 对照原文的 Flutter 调试配置.vscode/launch.json是 VSCode 调试入口。Flutter 项目的典型调试项如下你可以先复制一份最简配置排除其他扩展自动生成的内容{ version: 0.2.0, configurations: [ { name: Flutter, request: launch, type: dart, program: lib/main.dart, args: [--dart-defineENVdev] }, { name: Flutter (Profile Mode), request: launch, type: dart, program: lib/main.dart, flutterMode: profile } ] }如果你同时装了 React Native Tools、Dart、Flutter、Awesome Flutter Snippets 等多个扩展type可能被改写成别的值或者调试下拉框里出现两个同名 Flutter。把当前launch.json全文贴给 Codex让它对照 Flutter 插件官方行为检查type是不是dart。program是不是指向lib/main.dart。有没有多余的preLaunchTask指向不存在的任务。flutterMode是不是和request冲突。Codex 可以解释每个字段也可以生成一份干净的最小配置但保存文件、重新F5必须由你在 VSCode 里做。4.2 用 code --disable-extensions 定位冲突插件插件冲突的典型表现不是报错而是“调试按钮点了没反应”“热重载失效”“flutter doctor 输出正常但 F5 起不来”。原文给过一个粗暴但有效的办法禁用所有扩展启动。code --disable-extensions如果禁用后 Flutter 调试正常说明冲突来自扩展。然后逐个启用每启用一个就重载窗口再试一次F5。也可以开一个干净的用户数据目录避免污染当前配置code --user-data-dir ~/.vscode-android-clean这个新窗口里只装 Dart 和 Flutter 两个必需扩展再打开项目。把两次的调试输出贴给 Codex让它对比扩展列表和launch.json往往能定位到是哪个扩展改了调试类型。注意不要让 Codex 替你运行code --disable-extensions它只能在对话里给出命令执行还是在你本地。5. 构建失败flutter clean 与 gradlew clean 由你在本地执行5.1 Flutter 构建缓存的清理顺序flutter doctor过了F5也能起但flutter build apk失败常见于 Gradle 缓存、.dart_tool损坏、依赖版本冲突。原文常见问题里给过清理缓存的思路。你可以把完整报错贴给 Codex让它判断是 Gradle 版本、Android SDK 版本还是pubspec.yaml依赖问题。然后它在对话里生成清理命令你在本地终端执行flutter clean rm -rf .dart_tool flutter pub get flutter build apk --debugWindows 下如果没有rm -rf可以用Remove-Item -Recurse -Force .dart_tool执行完把新的输出贴回 Codex。如果报错变成Could not resolve ...再让它看pubspec.yaml和pubspec.lock。整个过程中Codex 只负责解释和生成命令编译、清理、下载依赖都在你本地完成它不能直接读你磁盘上的缓存目录。5.2 React Native 和 Java/Kotlin 的清理差异如果你在同一个 VSCode 工作区里切到 React Native 或 Java/Kotlin清理命令不一样。React Native 常见cd android ./gradlew clean cd .. rm -rf node_modules npm install npx react-native run-androidJava/Kotlin 原生项目常见./gradlew cleanBuildCache ./gradlew clean把这些命令和flutter doctor -v里的 Android toolchain 信息一起给 Codex让它判断是不是 Gradle JDK 和JAVA_HOME不一致。例如 Android Gradle Plugin 需要 JDK 17而flutter doctor -v显示 Java 却来自 JDK 11这时 Flutter 可能能跑Gradle 构建却失败。Codex 可以对照flutter doctor -v和./gradlew -v的输出指出差异你再本地调整JAVA_HOME重新打开终端验证。不要写成“让 Codex 直接连上 Gradle 执行构建”。正确链路是Codex 解释报错、生成命令你在本地终端执行把结果贴回来继续问。6. 验证 Codex 通道可用再回控制台看这次排障的用量6.1 让 Codex 发一条最小请求确认 Base URL 没多 /v1Codex 配置改完后先别急着贴大段日志。在 Codex 会话里发一条最小请求例如只回复 pong如果正常返回说明TAOTOKEN_API_KEY、base_url、model至少有一组是通的。如果报 401优先检查 Key 是否复制完整、环境变量是否在新终端里生效。如果报 404优先检查base_url是不是写成了https://taotoken.net/api/v1或者误把官网落地页带 UTM 的地址填进了base_url。记住填进 Codex 的base_url是https://taotoken.net/api末尾不要/v1。确认通道可用后再把flutter doctor -v、环境变量、launch.json分批发给 Codex。一次只问一类问题比如先问 Android toolchain再问调试插件最后问构建失败。这样 Codex 的上下文不会被几百行日志冲乱。6.2 用量页与新建 Key排障跑完一轮回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台看用量确认这次 Codex 调用有没有正常记上。如果同一天还要给另一个工具或另一台机器用建议直接新建一把 Key不要在多处复用同一把。控制台里也能看到模型广场当时列表换模型时以那里为准不要凭记忆写模型 ID。如果你准备把 Codex 长期放在 VSCode 里辅助安卓排障可以顺手看看 Coding Plan 的额度是否符合写代码习惯单次测试也可以在 TaoToken 模型对话 里用同一把 Key 发消息确认。需要新 Key 时入口在 控制台 API Keys。Flutter 环境本身还是靠你本地 PATH、JAVA_HOME、ANDROID_HOME 三件套TaoToken 只把 Codex 的通道接稳不让你在排障中途再卡在模型调用上。