1. Cursor 里 flutter pub get 到底在做什么很多刚把 Flutter 项目搬进 Cursor 的朋友第一次看到flutter pub get卡住或者报错第一反应是「是不是 Cursor 没编译成功」。这个理解其实偏了。flutter pub get不是编译它只做依赖准备解析pubspec.yaml里声明的包版本、把缺失的包拉到本地缓存、生成.dart_tool/package_config.json以及平台插件注册相关的元数据。真正把 Dart 代码 AOT/JIT 编译、打包资源、产出 APK/IPA 的是flutter build或flutter run。你可以把它类比成 iOS 开发里的pod install负责把声明的依赖解析出来、下载并写好配置文件让 IDE 和编译器能找到它们。而flutter build/flutter run才相当于 Xcode 里的 ⌘B / ⌘R。缺了pub get后续编译根本进行不下去但光有pub get你也拿不到可安装的应用。那为什么在 Cursor 里这件事特别容易出问题因为 Cursor 本质是一个编辑器外壳它不会替你管理 Flutter SDK 的 PATH也不会自动继承你终端里的环境变量。当你在 Cursor 内置终端敲flutter pub get它用的是 Cursor 进程的环境而不是你系统终端那套。于是就会出现「系统终端能跑、Cursor 里报错」的经典误判。这篇就围绕这个场景把 TaoToken 统一 Key 通道下的settings.json配置骨架讲清楚让你在 Cursor 内稳定完成pub get并快速排错。2. 先理清 Cursor 对 pub get 的三个常见误解在动手配settings.json之前得先把认知层面的坑填了否则配置改对了你也不知道为什么对。第一个误解是「pub get 等于编译」。前面已经说过它只生成元数据。你在 Cursor 里看到Running flutter pub get in xxx...然后结束不代表代码能跑只代表依赖图解析完了。第二个误解是「Cursor 报错就是 Flutter 坏了」。实际上 Cursor 内置终端的环境变量、工作目录、甚至 shell 类型都可能和你系统终端不同。比如你在 zsh 里配了PUB_HOSTED_URL但 Cursor 默认用 bash那这个变量就不生效。第三个误解是「网络通道问题只能靠改 hosts 解决」。依赖拉取走的是 HTTP 通道涉及PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL两个环境变量。如果你在用 TaoToken 这类统一 Key/API 通道做模型调用那 Flutter 的依赖通道和模型通道是两回事别混在一起配。下面这张表帮你把边界划清楚对比项flutter pub get真正的编译build/run解析并锁定 pubspec.yaml 版本是先隐式调用一次已最新则跳过下载包到 ~/.pub-cache是仅首次或版本变化时生成 package_config.json是依赖图变化时AOT/JIT 编译 Dart 代码否是产出 APK/IPA/web bundle否是注意把pub get当成编译会让你在排错时盯错方向。Cursor 里pub get失败九成是环境变量或工作目录问题不是代码问题。3. TaoToken 前置统一 Key 通道与 settings.json 骨架TaoToken 在这里扮演的角色是「统一 Key/API 通道」。你可以在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 了解整体能力API 入口是 https://taotoken.net/api。它的价值在于当你同时用 Cursor 做 Flutter 开发、又需要调用模型能力时不用在多个 Key 之间来回切换一个通道覆盖模型对话、编码计划、控制台和 API Keys 管理。但要注意Flutter 的pub get依赖通道和 TaoToken 的模型通道是两条独立的链路。settings.json里我们要配的是 Cursor 的终端环境让pub get能稳定跑而 TaoToken 的 Key 是给模型调用用的。两者在同一个配置文件里共存但各管各的。Cursor 的settings.json位于用户配置目录你可以通过命令面板Preferences: Open User Settings (JSON)打开。下面是一个可复制的骨架重点是把 Flutter 相关环境变量和终端行为固定下来{ terminal.integrated.env.linux: { PUB_HOSTED_URL: https://pub.dev, FLUTTER_STORAGE_BASE_URL: https://storage.googleapis.com, PATH: ${env:HOME}/flutter/bin:${env:PATH} }, terminal.integrated.env.osx: { PUB_HOSTED_URL: https://pub.dev, FLUTTER_STORAGE_BASE_URL: https://storage.googleapis.com, PATH: ${env:HOME}/flutter/bin:${env:PATH} }, terminal.integrated.env.windows: { PUB_HOSTED_URL: https://pub.dev, FLUTTER_STORAGE_BASE_URL: https://storage.googleapis.com }, terminal.integrated.cwd: ${workspaceFolder}, terminal.integrated.defaultProfile.osx: zsh, terminal.integrated.defaultProfile.linux: bash, dart.flutterSdkPath: ${env:HOME}/flutter, dart.sdkPath: ${env:HOME}/flutter/bin/cache/dart-sdk }这段配置做了几件事把 Flutter SDK 的 bin 目录塞进 PATH保证 Cursor 内置终端能找到flutter命令固定PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL避免依赖拉取时走错通道把终端工作目录锁到${workspaceFolder}防止在错误目录执行pub get显式指定 Dart/Flutter SDK 路径让 Dart 插件不再猜。如果你需要管理 TaoToken 的 Key可以走控制台 https://taotoken.net/console API Keys 在 https://taotoken.net/api-keys 。模型对话入口是 https://taotoken.net/models 编码计划在 https://taotoken.net/coding-plan 。这些和pub get不冲突但建议在同一个settings.json里用注释或分组区分开避免以后自己看混。4. 可复制配置从零到 pub get 跑通配置骨架有了接下来是完整操作流程。我按「先验证环境、再配 settings、最后跑 pub get」的顺序来每一步都有可复制的命令。第一步确认 Flutter SDK 路径。在系统终端执行which flutter flutter --version记下which flutter的输出比如/Users/you/flutter/bin/flutter那 SDK 根目录就是/Users/you/flutter。这个路径要填进settings.json的dart.flutterSdkPath。第二步打开 Cursor 的settings.json把上一节的骨架粘进去把${env:HOME}/flutter替换成你的真实路径。Windows 用户注意路径分隔符用双反斜杠或正斜杠。第三步重启 Cursor。这一步不能省终端环境变量只在进程启动时读取一次。重启后打开内置终端执行echo $PUB_HOSTED_URL echo $FLUTTER_STORAGE_BASE_URL flutter --version如果三个命令都有正常输出说明环境变量生效了。如果flutter提示 command not found回去检查 PATH 拼接是否正确。第四步进入 Flutter 项目目录执行pub getcd /path/to/your/flutter_project flutter pub get正常输出类似Running flutter pub get in flutter_project... Resolving dependencies... Got dependencies!看到Got dependencies!就说明依赖解析和下载都完成了。此时.dart_tool/package_config.json会被生成或更新。第五步如果你在 Cursor 里用 Dart 插件还需要确认插件识别到了 SDK。打开任意.dart文件底部状态栏应该显示 Flutter 版本号。如果显示No SDK说明dart.flutterSdkPath没配对回去检查路径。提示pub get成功后不要急着flutter run。先跑一次flutter doctor -v确认 Android/iOS 工具链没问题否则编译阶段的报错会让你误以为是pub get的锅。5. 验证请求与成功结果配置改完怎么确认真的生效了光看pub get成功还不够得做几个验证动作。验证一在 Cursor 内置终端和系统终端分别执行flutter pub get对比输出。如果两边都能Got dependencies!说明环境一致了。如果只有系统终端能跑说明settings.json的 env 配置没生效大概率是没重启 Cursor。验证二删掉.dart_tool目录重新pub get观察是否重新生成package_config.jsonrm -rf .dart_tool flutter pub get ls .dart_tool/package_config.json这个文件存在且内容包含你pubspec.yaml里声明的包就说明依赖解析链路完整。验证三故意在pubspec.yaml里写一个不存在的包版本比如http: ^999.0.0再跑pub get应该看到版本解析失败的报错。这能证明pub get确实在读你的配置文件而不是走了缓存。Because flutter_project depends on http ^999.0.0 which doesnt match any versions, version solving failed.看到这个报错说明通道是通的只是版本不存在。把版本改回去再跑一次恢复。验证四如果你同时用 TaoToken 做模型调用可以在 Cursor 里发一次模型对话请求确认 Key 通道正常。模型对话入口 https://taotoken.net/models API Keys 管理在 https://taotoken.net/api-keys 。这一步和pub get独立但能帮你确认整个 Cursor 环境是健康的。6. 本篇常见错排查即使配置对了实际用起来还是会遇到各种报错。下面这几个是我踩过的坑按出现频率排序。报错一flutter: command not foundCursor 内置终端找不到 flutter。原因通常是 PATH 没配或配错。检查settings.json里terminal.integrated.env.osx的 PATH 拼接确保${env:HOME}/flutter/bin在前面。改完必须重启 Cursor。报错二SocketException: Failed host lookup依赖拉取时域名解析失败。先确认PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL拼写正确没有多余斜杠。然后在 Cursor 终端执行ping pub.dev看网络是否通。如果系统终端能 ping 通而 Cursor 不能说明 Cursor 的代理设置和系统不一致检查settings.json里有没有残留的http.proxy配置。报错三Because xxx depends on yyy which doesnt match any versions版本冲突不是环境问题。用flutter pub deps查看依赖树找到冲突的包在pubspec.yaml里用dependency_overrides临时锁定版本。这个报错和 Cursor 无关系统终端也会出现。报错四pub get卡在Resolving dependencies...不动大概率是网络通道慢或缓存损坏。先执行flutter pub cache repair修复缓存再重试。如果还卡检查PUB_HOSTED_URL是否指向了不可达的地址。报错五Dart 插件显示No SDK但终端能跑 flutter这是插件配置和终端环境不同步。dart.flutterSdkPath必须指向 SDK 根目录不是 bin 目录。比如/Users/you/flutter而不是/Users/you/flutter/bin。改完重启 Cursor或者执行Developer: Reload Window。报错六pub get成功但编译时报package not found.dart_tool/package_config.json没更新。删掉.dart_tool和pubspec.lock重新pub get。如果还不行检查pubspec.yaml的environment段 SDK 版本约束是否和当前 Flutter 版本匹配。注意排错时优先看 Cursor 内置终端的完整输出不要只看弹窗提示。弹窗往往只给结论终端才有堆栈。7. 把配置沉淀成可复用骨架走到这里你应该已经在 Cursor 里稳定跑通pub get了。最后说一个实用技巧把settings.json里 Flutter 相关的配置抽成一个片段存在自己的笔记里。换机器或者重装 Cursor 时直接粘贴改一下 SDK 路径就能用。如果你需要长期在 Cursor 里做 Flutter 开发并且同时用模型能力辅助编码可以了解 TaoToken 的编码计划 https://taotoken.net/coding-plan 它把模型调用和编码场景做了整合。接入文档在 https://taotoken.net/doc ClaudeCodeAnthropic 相关入口是 https://taotoken.net/claudecode-anthropic 。这些和pub get是两条线但在同一个 Cursor 环境里共存配置时注意分组别把模型通道的变量和 Flutter 依赖通道的变量混在一起。实测下来最省事的做法是settings.json里只放环境变量和 SDK 路径模型相关的 Key 通过 TaoToken 控制台管理不写死在配置文件里。这样换 Key 不用改配置pub get也不会因为 Key 变动受影响。
