解决cursor-talk-to-figma-mcp项目中Bun安装后命令未找到问题

在开发cursor-talk-to-figma-mcp项目时，许多开发者会遇到安装Bun后无法识别命令的问题。本文将详细分析问题原因并提供完整的解决方案。

问题现象

当开发者按照官方文档安装Bun后，执行bun setup命令时，终端会提示"zsh: command not found: bun"。这种情况通常发生在macOS系统上，使用zsh作为默认shell的环境中。

根本原因

这个问题出现的原因是Bun的安装路径没有被正确添加到系统的PATH环境变量中。虽然安装脚本成功将Bun安装到了~/.bun/bin/目录下，但如果没有手动配置环境变量，系统就无法找到这个可执行文件。

解决方案

方法一：临时解决方案（仅当前会话有效）

1. 在终端中执行以下命令临时添加环境变量：

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

2. 验证是否生效：

bun --version

方法二：永久解决方案（推荐）

1. 打开zsh的配置文件：

nano ~/.zshrc

2. 在文件末尾添加以下内容：

# Bun配置
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

3. 保存文件并退出编辑器（在nano中按Ctrl+O保存，Ctrl+X退出）

4. 使配置立即生效：

source ~/.zshrc

5. 验证配置：

echo $PATH

应该能在输出中看到~/.bun/bin路径

验证安装

完成上述步骤后，可以通过以下命令验证Bun是否安装成功：

bun --version

如果正确显示版本号，说明配置成功。此时可以继续执行项目中的bun setup命令。

注意事项

1. 如果使用其他shell（如bash），需要修改对应的配置文件（如~/.bashrc或~/.bash_profile）

2. 在某些系统上，可能需要重启终端才能使配置完全生效

3. 如果问题仍然存在，可以尝试完全卸载后重新安装Bun

4. 确保~/.bun/bin目录确实存在并且包含bun可执行文件

通过以上步骤，开发者应该能够顺利解决Bun命令未找到的问题，继续cursor-talk-to-figma-mcp项目的开发工作。