VSCode配置Dart语言环境(跨平台开发，Flutter必备)-VSCode-PHP中文网

VSCode配置Dart语言环境(跨平台开发，Flutter必备)

星夢妙者

发布： 2025-08-12 18:32:01

原创

1093人浏览过

要配置vscode以支持dart语言，必须先安装dart sdk并配置环境变量，再在vscode中安装dart插件。1. 安装dart sdk：从官网下载对应操作系统的安装包，windows用户解压后将bin目录添加到系统path，macos用户可通过homebrew安装并配置shell配置文件如~/.zshrc添加export path="$path:/path/to/dart-sdk/bin"，然后执行source命令生效；2. 验证安装：在命令行输入dart --version显示版本信息即成功；3. 安装dart插件：在vscode扩展中搜索“dart”并安装官方插件，若开发flutter还需安装flutter插件；4. 配置settings.json（可选）：如插件未自动识别sdk路径，需手动在vscode设置中指定dart.sdkpath；5. 解决插件无法激活问题：检查sdk路径配置、重启或重装插件、查看输出面板错误信息、确保sdk与插件兼容，flutter用户可运行flutter doctor诊断；6. 调试dart代码：在项目中创建launch.json文件，选择调试配置如“dart: launch program”，设置断点后按f5启动调试，使用调试工具栏进行单步执行和变量查看，问题排查可依赖输出面板信息。完成这些步骤后，你就能在vscode中顺利编写、运行和调试dart代码了。

VSCode配置Dart语言环境(跨平台开发，Flutter必备)

要配置VSCode以支持Dart语言，核心在于安装Dart SDK和VSCode的Dart插件。这两个步骤完成后，你就能在VSCode中编写、运行和调试Dart代码了，特别是对于Flutter开发者来说，这是必不可少的一步。

安装Dart SDK和Dart插件，并进行必要的配置。

如何安装Dart SDK？

安装Dart SDK是使用Dart语言的第一步。你可以直接从Dart官网下载对应你操作系统的安装包。安装完成后，需要配置环境变量，将Dart SDK的

bin

登录后复制

目录添加到你的

PATH

登录后复制

中。这样，你才能在命令行中直接使用

dart

登录后复制

命令。

具体步骤如下：

下载Dart SDK： 访问Dart官网，根据你的操作系统（Windows, macOS, Linux）下载对应的SDK。
安装SDK： 按照官方文档的指引进行安装。Windows平台通常是解压到一个目录，macOS则是通过Homebrew等包管理器安装。
配置环境变量： 这是关键一步。
- Windows: 打开“控制面板” -> “系统和安全” -> “系统” -> “高级系统设置” -> “环境变量”。在“系统变量”中找到
```
PATH
```
  登录后复制
  ，点击“编辑”，添加Dart SDK的
```
bin
```
  登录后复制
  目录（例如：
```
C:\dart-sdk\bin
```
  登录后复制
  ）。
- macOS/Linux: 打开你的shell配置文件（例如
```
~/.bashrc
```
  登录后复制
  或
```
~/.zshrc
```
  登录后复制
  ），添加以下行：
```
export PATH="$PATH:/path/to/dart-sdk/bin"
```
  登录后复制
  替换
```
/path/to/dart-sdk
```
  登录后复制
  为你的Dart SDK实际安装路径。执行
```
source ~/.bashrc
```
  登录后复制
  或
```
source ~/.zshrc
```
  登录后复制
  使配置生效。
  
  依图语音开放平台
  依图语音开放平台
  
  6
  
  查看详情
验证安装： 打开命令行，输入
```
dart --version
```
登录后复制
，如果能正确显示Dart SDK的版本信息，说明安装成功。

如何在VSCode中安装和配置Dart插件？

安装完Dart SDK后，下一步是在VSCode中安装Dart插件。这个插件提供了代码补全、语法高亮、调试等功能，极大地提升开发效率。

安装Dart插件： 打开VSCode，点击左侧的扩展图标（或按下
```
Ctrl+Shift+X
```
登录后复制
），搜索“Dart”，找到Dart官方插件并安装。
安装Flutter插件（可选）： 如果你计划使用Flutter进行开发，也建议安装Flutter插件。它依赖于Dart插件，并提供了Flutter相关的工具和模板。
配置
settings.json
登录后复制
（可选）：有时候，你可能需要手动配置VSCode的
```
settings.json
```
登录后复制
文件，例如指定Dart SDK的路径。但通常情况下，插件会自动检测到SDK。如果需要手动配置，可以打开VSCode的设置（
```
Ctrl+,
```
登录后复制
），搜索“Dart SDK Path”，然后输入你的Dart SDK路径。

解决VSCode Dart插件无法激活的问题

有时候，即使安装了Dart插件，VSCode也可能无法正确激活它。这通常是由于SDK路径配置不正确或者插件本身的问题。

检查SDK路径： 确保你的Dart SDK路径在环境变量中配置正确，并且VSCode的
```
settings.json
```
登录后复制
文件中的
```
dart.sdkPath
```
登录后复制
也指向正确的路径。
重启VSCode： 尝试重启VSCode，有时候重启可以解决一些插件加载的问题。
重新安装插件： 如果重启无效，可以尝试卸载Dart插件，然后重新安装。
查看VSCode的输出面板： 打开VSCode的“查看” -> “输出”面板，选择“Dart”或“Flutter”输出，查看是否有错误信息。根据错误信息排查问题。
检查Dart SDK版本： 确保你的Dart SDK版本与Dart插件兼容。有时候，插件可能不支持过旧的SDK版本。
考虑使用Flutter Doctor： 如果是Flutter项目，运行
```
flutter doctor
```
登录后复制
命令，它可以检测并修复Flutter和Dart环境中的问题。

如何调试Dart代码？

配置好Dart环境后，就可以开始调试Dart代码了。

创建launch.json文件： 在VSCode中打开你的Dart项目，点击“运行” -> “添加配置”，选择“Dart: Attach to Process”或“Dart: Launch Program”。这会创建一个
```
.vscode/launch.json
```
登录后复制
文件，其中包含了调试配置。
配置launch.json： 根据你的项目类型，修改
```
launch.json
```
登录后复制
文件。例如，如果你要调试一个命令行程序，需要指定程序的入口文件。
设置断点： 在你的Dart代码中设置断点，点击行号左侧的空白区域即可。
启动调试： 点击VSCode的调试按钮（或按下
```
F5
```
登录后复制
），启动调试。VSCode会运行你的程序，并在断点处暂停。
调试： 使用VSCode的调试工具栏，可以单步执行代码、查看变量的值、设置监视等。