打开Flutter项目报Request textDocument/codeAction failed错误如何解决

1. 优先校验项目路径合法性 #

• 检查你的Flutter项目完整路径是否包含中文字符、空格、特殊符号（如 emoji、&、*等），你使用的Dart 2.13.3版本对应的语言服务器对非ASCII、含特殊字符的路径解析兼容性极差，初始化Git后触发全量路径索引时就会出现解析异常
• 如果路径不符合要求，将项目移动到纯英文、无特殊字符、无空格的目录下重新打开测试

2. 清理Dart/Flutter插件的缓存索引 #

• 完全关闭VS Code，找到对应系统的缓存目录删除：
  • Windows：删除%APPDATA%\Code\User\workspaceStorage下所有和当前项目关联的文件夹，或者直接清空整个目录
  • macOS：删除~/Library/Application Support/Code/User/workspaceStorage下对应项目的缓存目录
  • Linux：删除~/.config/Code/User/workspaceStorage下对应项目的缓存目录
• 进入项目根目录，删除.dart_tool、.idea、.vscode三个隐藏文件夹，之后执行flutter clean，再执行flutter pub get重新拉取依赖

3. 校验Git相关配置冲突 #

• 你是在初始化Git仓库后出现问题，检查项目根目录.gitignore是否误包含了.dart_tool或者pub相关的缓存目录，如果有把对应条目删除
• 执行git status检查是否有未提交的dart/flutter配置文件变更，先全部提交或暂存后重启VS Code

4. 适配插件与SDK版本 #

你使用的VS Code 1.59.1属于较老版本，和最新的Dart/Flutter插件存在兼容性问题：

• 卸载当前Dart、Flutter VS Code插件，安装对应适配版本：Dart插件v3.25.1、Flutter插件v3.25.0，这两个版本是匹配Flutter 2.2.2、Dart 2.13.3的最后兼容版本

5. 强制重置Dart语言服务器配置 #

打开VS Code设置，搜索dart.sdkPath，手动指定你本地Flutter内置的Dart SDK路径（即Flutter安装目录下的/bin/cache/dart-sdk路径），避免插件自动检索路径出错。
重启VS Code后按Ctrl+Shift+P（macOS按Cmd+Shift+P）调出命令面板，执行Dart: Restart Analysis Server命令。

内容的提问来源于stack exchange，提问作者Sanzid Sadman