最可靠的方式是用 dart create 命令初始化项目，它生成符合 pub.dev 规范的完整骨架，VS Code 打开后能自动识别 Dart/Flutter 支持；需先安装独立 Dart SDK，再执行 dart create my_app，进入目录后 code . 打开，确保状态栏显示 Dart 版本并成功执行 dart pub get。
用 dart create 命令初始化项目最可靠
VS Code 本身不内置 Dart 项目模板，直接点“新建文件夹 → 打开”再手动配 pubspec.yaml 容易漏依赖或结构错位。真正省事又标准的做法，是先用 Dart CLI 初始化——它会生成符合 pub.dev 规范的完整骨架，VS Code 后续打开就能自动识别并加载 Dart/Flutter 支持。
实操建议：
- 确保已安装 Dart SDK（运行
dart --version能输出版本号，不是靠 Flutter 自带的 dart） - 终端进入目标父目录，执行：
dart create my_app（my_app是项目名，小写字母+下划线，别用大写或空格） - 生成后进到该目录：
cd my_app，再用 VS Code 打开：code . - 首次打开时，VS Code 会提示安装 Dart 插件（如果没装），装完重启窗口，状态栏右下角应显示
Dart: v3.7.x
为什么不能只靠 VS Code 的“Empty Project”模板
VS Code 的“新建文件夹 → 初始化为 Git 仓库”这类操作，不会生成 pubspec.yaml、bin/ 或 test/ 目录，也不会设置正确的 analysis_options.yaml。Dart 分析器会报 Could not resolve package 或直接不识别 import，连基础补全都失效。
常见错误现象：
- 输入
import 'package:后无任何包提示 - 右键
Run没反应，终端报错No pubspec.yaml found -
dart run报Could not find a file named "pubspec.yaml"
dart create 的常用参数和场景差异
默认生成的是命令行应用（bin/main.dart 入口）。但你可能需要库、包或 Web 项目——这时得加参数，否则后期改结构很麻烦。
关键参数：
- 建纯库（不带
bin/，供其他项目import）：dart create -t package my_lib - 建 Web 项目（含
web/index.html和web/main.dart）：dart create -t web-simple my_web_app - 建支持测试的完整结构（含
test/和analysis_options.yaml）：dart create -t console-full my_tool - 所有模板列表：
dart create -h查看-t可选项
注意：-t package 生成的项目默认没有可执行入口，别误以为“跑不起来”就是失败。
打开项目后必须确认的三件事
VS Code 看似打开了，但 Dart 插件未必真正就绪。很多问题其实卡在这几步。
检查清单：
- 状态栏右下角是否显示
Dart（不是Plain Text或Markdown）——点击可切换语言模式 - 打开
pubspec.yaml，右上角是否出现Pub: Get Dependencies按钮？没出现说明插件未激活，尝试重载窗口（Ctrl+Shift+P→Developer: Reload Window） - 终端执行
dart pub get是否成功？失败常见原因是镜像源被墙（国内用户需配置https://pub.flutter-io.cn）
容易被忽略的一点：VS Code 的工作区设置（.vscode/settings.json）里如果写了 "dart.sdkPath"，而路径已失效，会导致分析器静默崩溃——删掉这行，让插件自动探测更稳。
