最可靠的方式是用 dart create 命令初始化项目,它生成符合 pub.dev 规范的完整骨架,VS Code 打开后能自动识别 Dart/Flutter 支持;需先安装独立 Dart SDK,再执行 dart create my_app,进入目录后 code . 打开,确保状态栏显示 Dart 版本并成功执行 dart pub get。
用
命令初始化项目最可靠
VS Code 本身不内置 Dart 项目模板,直接点“新建文件夹 → 打开”再手动配
容易漏依赖或结构错位。真正省事又标准的做法,是先用 Dart CLI 初始化——它会生成符合 pub.dev 规范的完整骨架,VS Code 后续打开就能自动识别并加载 Dart/Flutter 支持。
实操建议:
确保已安装 Dart SDK(运行
能输出版本号,不是靠 Flutter 自带的 dart)
终端进入目标父目录,执行:
(
是项目名,小写字母+下划线,别用大写或空格)
生成后进到该目录:
,再用 VS Code 打开:
首次打开时,VS Code 会提示安装 Dart 插件(如果没装),装完重启窗口,状态栏右下角应显示
为什么不能只靠 VS Code 的“Empty Project”模板
VS Code 的“新建文件夹 → 初始化为 Git 仓库”这类操作,不会生成
、
或
目录,也不会设置正确的
。Dart 分析器会报
或直接不识别
,连基础补全都失效。
常见错误现象:
输入
后无任何包提示
右键
没反应,终端报错
报
的常用参数和场景差异
默认生成的是命令行应用(
入口)。但你可能需要库、包或 Web 项目——这时得加参数,否则后期改结构很麻烦。
关键参数:
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
建纯库(不带
,供其他项目
):
建 Web 项目(含
和
):
建支持测试的完整结构(含
和
):
所有模板列表:
查看
可选项
注意:
生成的项目默认没有可执行入口,别误以为“跑不起来”就是失败。
打开项目后必须确认的三件事
VS Code 看似打开了,但 Dart 插件未必真正就绪。很多问题其实卡在这几步。
检查清单:
状态栏右下角是否显示
(不是
或
)——点击可切换语言模式
打开
,右上角是否出现
按钮?没出现说明插件未激活,尝试重载窗口(
→
)
终端执行
是否成功?失败常见原因是镜像源被墙(国内用户需配置
)
容易被忽略的一点:VS Code 的工作区设置(
)里如果写了
,而路径已失效,会导致分析器静默崩溃——删掉这行,让插件自动探测更稳。
dart createpubspec.yamldart --versiondart create my_appmy_appcd my_appcode .Dart: v3.7.xpubspec.yamlbin/test/analysis_options.yamlCould not resolve packageimportimport 'package:RunNo pubspec.yaml founddart runCould not find a file named "pubspec.yaml"dart createbin/main.dartbin/importdart create -t package my_libweb/index.htmlweb/main.dartdart create -t web-simple my_web_apptest/analysis_options.yamldart create -t console-full my_tooldart create -h-t-t packageDartPlain TextMarkdownpubspec.yamlPub: Get DependenciesCtrl+Shift+PDeveloper: Reload Windowdart pub gethttps://pub.flutter-io.cn.vscode/settings.json"dart.sdkPath"