Windows系统下为Dart项目安装fswatch遇阻，求指导

一、推荐安装方式（新手首选：包管理器） #

1. Chocolatey安装 #

• 打开管理员模式的PowerShell，先检查Chocolatey是否已安装：

  choco --version
  

• 未安装的话，执行以下命令安装Chocolatey：

  Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  

• 安装fswatch：

  choco install fswatch -y
  

• 验证安装成功：

  fswatch --version
  

2. Scoop安装 #

• 打开PowerShell（无需管理员，但需设置执行策略），先安装Scoop：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; irm get.scoop.sh | iex
  

• 安装fswatch：

  scoop install fswatch
  

• 验证安装：

  fswatch --version
  

二、手动安装（包管理器失败时备选） #

• 下载fswatch的Windows预编译二进制压缩包（从官方发布渠道获取对应版本）
• 解压到无中文、无空格的本地路径，例如C:\tools\fswatch
• 添加路径到系统环境变量：
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到Path，点击「编辑」
  3. 点击「新建」，粘贴解压后的fswatch可执行文件所在路径，点击「确定」
• 重启终端，执行fswatch --version验证

三、Dart项目中集成fswatch #

fswatch是命令行工具，可通过Dart的dart:io模块调用，示例脚本如下：

import 'dart:io';

void main() async {
  // 监控项目的lib目录（递归监控子目录）
  final process = await Process.start(
    'fswatch',
    ['-r', 'lib/'],
    runInShell: true,
  );

  // 监听文件变化输出
  process.stdout.transform(SystemEncoding.decoder).listen((data) {
    print('检测到文件变化: $data');
    // 可在此添加自定义逻辑：如触发测试、热重载等
  });

  // 监听错误信息
  process.stderr.transform(SystemEncoding.decoder).listen((data) {
    print('fswatch错误: $data');
  });
}

四、避坑提示与注意事项 #

• 安装包管理器或修改环境变量时，必须使用管理员权限的终端，否则会出现权限不足报错。
• 安装完成后必须重启终端，否则系统无法识别fswatch命令。
• 手动安装时，禁止将fswatch放在含中文或空格的路径下，否则Dart调用时会出现路径解析失败。
• Chocolatey安装失败时，先执行choco upgrade chocolatey更新包管理器，再重新安装fswatch。
• Scoop安装前，确保PowerShell执行策略已设置为RemoteSigned，否则无法运行安装脚本。
• Dart脚本中调用fswatch时，必须添加runInShell: true参数，否则可能找不到可执行文件。
• 避免监控过大的目录（如整个系统盘），会导致性能损耗甚至程序无响应。

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