1. 为什么要在 VSCode 里折腾 Dart 环境Dart 这门语言这两年被问得越来越多原因很直接Flutter 用它写跨端 UI服务端也能用 dart 写命令行工具和接口。很多人第一次接触 Dart 不是主动想学而是被 Flutter 项目带着走结果卡在第一步——编辑器里跑不起来。VSCode 是大多数人的主力编辑器轻、插件生态全但 Dart 的环境配置有几个坑SDK 路径没配对、终端编码乱码、Code Runner 和 Dart 插件打架、dart run找不到入口文件。这篇就围绕「VSCode 下 Dart 环境搭建 首次编译运行」这条线走一遍。我会给出settings.json里 Dart SDK 路径和 TaoToken 统一 Key 的可复制配置骨架然后实际演示dart run和dart compile两个验证动作确认环境真的可用。适合刚装完 VSCode、还没跑通第一个 Dart 文件的开发者。整个过程不需要你懂 Flutter纯 Dart 命令行就能验证。先说清楚 TaoToken 在这里的角色它是一个统一管理模型 Key 和调用入口的平台官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。你在写 Dart 代码时如果想让编辑器里的 AI 辅助、代码补全、或者自己写的 Dart 脚本调用模型能力用同一个 Key 就能接上不用每个工具单独配一遍。下面会把它和 Dart 环境配置串起来讲。2. 前置准备Dart SDK、VSCode 插件与 TaoToken Key2.1 装 Dart SDK 并确认版本去 Dart 官网下载 stable 稳定版Windows 选.zip或安装包都行macOS 用brew install dartLinux 按发行版走 apt 或直接下压缩包。装完打开终端验证dart --version正常会输出类似Dart SDK version: 3.5.x (stable)。如果提示command not found说明dart-sdk/bin没进 PATH。Windows 在「系统属性 → 高级 → 环境变量」里把dart-sdk\bin加进 PathmacOS/Linux 在~/.zshrc或~/.bashrc里加export PATH$PATH:/你的路径/dart-sdk/bin改完重开终端再验一次。这一步别跳过后面 VSCode 找不到 SDK 十有八九是这里没配好。2.2 VSCode 装两个插件在扩展商店搜两个Dart官方插件提供语言服务、调试、格式化和Code Runner右键一键运行。装完重启 VSCode。注意 Dart 插件本身已经能跑dart runCode Runner 是补充两者配置要协调后面排障会讲冲突怎么处理。2.3 拿 TaoToken 统一 Key打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存。这个 Key 就是你后续在 Dart 脚本、编辑器 AI 辅助里统一用的凭证。接入文档在 https://taotoken.net/doc 需要查参数时对着看。Key 只显示一次丢了就重建一个别硬找。3. 可复制配置settings.json 里的 Dart 路径与统一 Key3.1 打开 settings.jsonVSCode 里按CtrlShiftPmacOS 是CmdShiftP输入Open User Settings (JSON)回车。这是用户级配置对所有项目生效。如果你只想给当前项目配就在项目根目录建.vscode/settings.json。3.2 Dart SDK 路径配置把下面这段贴进去路径换成你自己的实际安装位置{ dart.sdkPath: C:\\tools\\dart-sdk, dart.flutterSdkPath: , dart.checkForSdkUpdates: true, dart.analysisExcludedFolders: [.dart_tool, build], editor.formatOnSave: true, [dart]: { editor.defaultFormatter: Dart-Code.dart-code, editor.tabSize: 2 } }dart.sdkPath指向 SDK 根目录不是bin目录这点容易搞错。macOS/Linux 写成/usr/local/dart-sdk这种形式。dart.flutterSdkPath如果你没装 Flutter 就留空装了再填。3.3 Code Runner 与终端编码配置乱码是高频问题加上这两行{ code-runner.runInTerminal: true, code-runner.executorMap: { dart: dart run }, terminal.integrated.defaultProfile.windows: PowerShell }code-runner.runInTerminal让输出走集成终端而不是输出面板中文就不会变问号。executorMap把 Dart 的执行命令固定成dart run避免 Code Runner 默认用dart直接跑导致找不到入口。3.4 统一 Key 的环境变量写法TaoToken 的 Key 不要硬编码进源码提交到仓库。推荐用环境变量在 Dart 里通过Platform.environment读取。VSCode 的settings.json可以给集成终端注入环境变量{ terminal.integrated.env.windows: { TAOTOKEN_API_KEY: 你的Key }, terminal.integrated.env.osx: { TAOTOKEN_API_KEY: 你的Key }, terminal.integrated.env.linux: { TAOTOKEN_API_KEY: 你的Key } }这样在 VSCode 集成终端里跑 Dart 脚本就能直接读到TAOTOKEN_API_KEY。注意这是本机配置别把带 Key 的settings.json传到公开仓库。4. 验证请求dart run 与 dart compile 全流程4.1 建项目与入口文件新建一个文件夹终端里执行dart create -t console-full hello_dart cd hello_dart这会生成标准结构入口在bin/hello_dart.dart。打开bin/hello_dart.dart改成下面这样顺便验证环境变量读取import dart:io; void main(ListString arguments) { final apiKey Platform.environment[TAOTOKEN_API_KEY]; if (apiKey null || apiKey.isEmpty) { print(未读取到 TAOTOKEN_API_KEY请检查 VSCode 终端环境变量配置); return; } print(Dart 环境正常统一 Key 已读取长度: ${apiKey.length}); print(参数: $arguments); }4.2 dart run 验证在 VSCode 集成终端里执行dart run bin/hello_dart.dart --demo预期输出Dart 环境正常统一 Key 已读取长度: 48 参数: [--demo]看到这行说明三件事都通了SDK 路径对、终端能读到环境变量、dart run能正常执行入口文件。如果 Key 长度是 0 或者提示未读取到回到 3.4 检查环境变量并且确认你是在 VSCode 集成终端里跑不是在系统外部终端。4.3 dart compile 验证dart run是解释执行dart compile是编译成可执行文件验证编译链是否完整dart compile exe bin/hello_dart.dart -o hello_dart.exemacOS/Linux 去掉.exe后缀。编译成功会输出Generated: /你的路径/hello_dart.exe。然后直接运行产物./hello_dart.exe --compiled输出和dart run一致说明 AOT 编译也通了。这一步能过你的 Dart 环境就算彻底可用后面写 Flutter 或者命令行工具都不会再卡在环境上。4.4 用 Code Runner 右键跑一次回到编辑器在hello_dart.dart里右键选Run Code。因为前面配了code-runner.runInTerminal和executorMap它实际执行的是dart run输出会出现在集成终端中文正常显示。如果右键跑出来是乱码或者报找不到文件看下一节的排查。5. 本篇常见错排查5.1 报错 Could not find a command named ... 或 SDK 找不到现象VSCode 底部状态栏显示Dart SDK not found或者运行时报找不到 dart 命令。原因基本是dart.sdkPath指错了层级指到了bin里面。正确写法是指到 SDK 根目录比如C:\tools\dart-sdk而不是C:\tools\dart-sdk\bin。改完按CtrlShiftP执行Dart: Restart Analysis Server让插件重新加载。5.2 终端中文乱码现象print(中文)输出成问号或方块。先确认code-runner.runInTerminal是true。Windows 上如果还乱码在 PowerShell 里执行chcp 65001切到 UTF-8或者把terminal.integrated.defaultProfile.windows设成 PowerShell 而不是 cmd。另外确认源文件保存编码是 UTF-8VSCode 右下角能看到。5.3 Code Runner 和 Dart 插件冲突现象右键 Run Code 报Error: No such file or directory或者跑的是旧代码。这是 Code Runner 默认命令和 Dart 插件不一致导致的。按 3.3 配好executorMap里的dart: dart run并且确保code-runner.runInTerminal为true。如果还冲突可以直接用 Dart 插件自带的运行按钮编辑器右上角的三角它走的是dart run更稳。5.4 环境变量读不到现象脚本里Platform.environment[TAOTOKEN_API_KEY]返回 null。三个检查点一是环境变量配在settings.json的terminal.integrated.env.*里不是系统环境变量二是必须新开一个集成终端旧终端不会自动加载新配置三是 Key 字符串别带多余空格或引号。改完关掉终端重新开一个再跑。5.5 dart compile 报找不到入口现象dart compile exe报No main function或路径错误。确认你指定的文件里有void main()并且路径写对。dart compile exe bin/hello_dart.dart里的路径是相对当前终端工作目录的如果你在项目根目录执行就没问题。产物输出路径用-o指定别省。6. 把统一 Key 接进你的 Dart 工作流环境跑通之后TaoToken 的 Key 就能在几个地方用起来。写 Dart 脚本调用模型接口时从环境变量读 Key请求发到 https://taotoken.net/api 具体路径和参数对着 https://taotoken.net/doc 填。如果你在 VSCode 里用 AI 辅助写 Dart 代码想验证模型返回效果可以直接开 https://taotoken.net/model-conversation 对话测试确认 Key 和模型都正常再写进代码。长期写 Dart 或 Flutter 项目、需要频繁调用模型的可以看 https://taotoken.net/coding-plan 按套餐走比单次调用省心。Key 管理和用量在 https://taotoken.net/console 看接入细节查 https://taotoken.net/api-keys 和 https://taotoken.net/doc 。Claude Code 相关的接入参考 https://taotoken.net/ClaudeCodeAnthropic 。最后给个实用习惯把TAOTOKEN_API_KEY只放在本机settings.json或系统环境变量里源码里永远用Platform.environment读.gitignore里加上.vscode/settings.json如果团队共享配置就改用.env加dotenv包。这样环境配置和密钥管理就都干净了换机器时只改本机配置代码一行不用动。