Flutter Web项目无法构建（两周前可正常构建）求助

问题根源 #

项目所在磁盘卷名称包含#字符（ModesSSD#1），而#在URI规范中是片段标识符，dart2js编译时无法正确解析带#的文件路径，导致无法读取生成的main.dart文件，最终抛出编译失败错误。

解决方法 #

方法一：修改磁盘卷名称 #

• 断开该外部磁盘连接
• 打开Mac「磁盘工具」，找到目标磁盘右键选择「重命名」
• 删除名称中的#符号（例如改为ModesSSD1）
• 重新挂载磁盘，在项目路径下执行flutter build web

方法二：迁移项目到无特殊字符路径 #

• 将项目完整复制到Mac内置磁盘（如~/Projects目录）
• 终端切换到新项目路径，执行：

  flutter clean
  flutter pub get
  flutter build web
  

通用辅助步骤 #

无论采用哪种方法，建议先清理构建缓存，避免残留问题：

flutter clean
rm -rf .dart_tool
flutter pub get

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