常见问题

安装完成后需要重新加载配置。运行以下命令，或者直接重新打开终端：

source ~/.zshrc

安装 Homebrew 和 Xcode 命令行工具时需要管理员密码，这是正常的。输入你的 Mac 登录密码即可（输入时不会显示字符）。

需要安装 Xcode 命令行工具。运行：

xcode-select --install

在弹出的窗口中点击「安装」，等待完成后重新运行脚本。

这是 Windows PowerShell 的执行策略（Execution Policy）限制，默认禁止运行未签名的 .ps1 脚本。

方法一：临时允许当前窗口运行脚本（推荐，关闭窗口后自动恢复）：

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

然后重新运行安装命令即可。

方法二：一行命令直接绕过执行：

powershell -ExecutionPolicy Bypass -File .\devbox-win.ps1 install -Coding -VSCode

方法三：为当前用户永久允许运行远程签名脚本：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

以上方法均不会影响系统安全策略。

不需要。Scoop 安装在用户目录下，无需管理员权限。如果你以管理员身份运行，脚本会自动检测并全局安装。

Windows 会将 python 命令重定向到 Microsoft Store。脚本会自动安装真正的 Python 并覆盖这个行为。如果仍有问题，重新打开 PowerShell 即可。

如果你没有代理，强烈建议使用 --china 参数。它会自动配置清华、淘宝等国内镜像源，下载速度会快很多。

如果你已经有代理（科学上网），可以不加这个参数。

运行 status 命令查看当前环境：

# macOS
./devbox-mac.sh status

# Windows
.\devbox-win.ps1 status

欢迎在 GitHub Issues 提交问题，我们会尽快回复。