love530love的博客

工作记录【PyCharm使用基础】当遇到虚拟环境难以修复的场景，我们需要删除当前解释器和虚拟环境然后再重新创建虚拟环境，以下是在PyCharm中正确移除的步骤。

工作记录。

这样 Cargo 会初始化一个现有目录，使其成为 Rust 项目，而不会创建重复的文件。这会进行语法检查，但不会生成二进制文件。安装完成后，需要更新。

采用升级 MSYS2 Python 版本或下载安装旧版 Python 的方案，而是。关于SUNA在Windows系统下的Poetry环境部署我们最终。，并确保 Python 头文件和库正确安装，成功解决了所有问题。，并确保 Rust 工具链匹配 Python 的库格式。，不包含任何 Python 版本升级或更换方案，仅记录。，并且它已经正确编译并安装到 Poetry 虚拟环境中。，Rust 的 GNU 工具链可以正确链接。现在可以继续项目开发了！，解决 Poetry 下载。，避免了 MSVC 需要。

在旧版 MSYS2（安装在 D 盘）中，由于自带的 Rust 版本较旧以及 PATH 环境变量的限制，导致了构建 Rust 依赖失败的问题。通过手动下载安装 Rustup，并在 MSYS2 中调整 PATH 变量，让系统使用 Rustup 管理的新工具链，最终成功升级到 Rust 1.87.0，从而解决了编译依赖的问题。这份笔记记录了整个处理过程和关键步骤，供未来参考和类似环境下的故障排查使用。如果今后遇到其它问题，也可以依此方法进行详细的排查和处理。

如果在后续使用过程中出现新的问题，可以随时参考这些步骤进行排查！经过这些步骤，MSYS2 运行 Rust 和 Cargo 的环境已经正确配置，环境中使用 Rust 和 Cargo，可能会遇到。以下是解决该问题的详细过程和关键步骤。安装完成后，再次检查 Rust 版本是否正确。，否则 Cargo 相关工具可能无法运行。作为依赖项，如果没有安装该库，可能会导致。需要更高版本的 Rust（如。如果所有包都是最新的，则说明。已成功安装并可以正常运行！在 Windows 的。中执行以下命令，检查。

工作记录。

通过重装历史版本 MSYS2 实现 Python 降级是当前最可靠的方案，核心在于精准匹配 Python 版本对应的安装包发布周期。操作时需严格验证安装包来源及版本信息，确保环境稳定适配项目需求。后续若需升级或降级 Python 版本，可重复此流程安装更高版本的 MSYS2 环境。

工作记录，下面是为该环境准备的最全工具链安装命令（包括 C/C++、Python、pip/wheel、GTK3/GTK4、PyGObject、Cairo、SDL2 等）。这一环境适用于构建原生 64 位 Windows 应用程序。

Virtualenv（.venv）方案：存在“Poetry 环境脱离项目目录”与“Windows 下 GTK 依赖缺失”两大问题，无法完成部署。Poetry 原生方案Python 3.12/3.11 + Poetry（项目目录）：只解决了环境位置可控，但依旧因 GTK 缺失或后端包兼容问题导致部署失败。：利用 MSYS2 的pacman安装 GTK/cairo、Node.js、make、工具链，最终前后端部署都成功，是目前唯一可行方案。部署优先级Docker 部署（一键容器化）——最省心；

在 Python 3.12+ 虚拟环境中安装tokenizers库时，我们可能会遇到pip install tokenizers安装失败和找不到适配版本的公开whl文件，从而导致tokenizers库缺失的问题。经过探索，我们找到了一种可行的解决方案，尝试通过命令下载兼容版本，再进行本地安装。

工作记录部署排错参考资料在文末 或查找往期笔记。

运行api.py这表示端口8000已被系统中的其他进程占用，导致Uvicorn无法正常启动。

在跨平台项目中，推荐用 webdriver-manager 等库自动管理 chromedriver。如果后续我们切换了 chromedriver 的位置，只需同步更新这条路径即可。如果项目成员较多，可以在项目 README 中说明该路径依赖，或使用。或配置项显式指定 chromedriver 路径。在 Windows 中已将。但在项目虚拟环境（如。

这样可以强制用 UTF-8 编码读取配置文件，避免字符解析出错。是使用 UTF-8 编码保存的，其中可能包含。Python 默认在 Windows 上使用。项目中的文本文件建议统一使用。无法识别的字符，导致报错。的好习惯，特别是在读取。项目根目录下api.py。

以下是。

通过以上流程，可系统性完成 Suna 在 Windows 的部署，结合专栏中的具体问题排查案例，能有效避开环境兼容、依赖缺失、配置错误等核心坑点。因篇幅有限，所有涉及处理步骤的详细处理办法请参考文末资料。指定 MSYS2 的 Python（如。：若用系统默认 Python，需通过。F:\项目\suna。docker 未运行。

在基于 MSYS2（MINGW64）中 Python 创建的 Poetry 虚拟环境里，安装 Suna 开源项目相关包时编译失败，阻碍项目正常部署。文件夹 ），复制这些文件夹到 MSYS2（MINGW64）的 Poetry 虚拟环境的。新建相同 Python 版本虚拟环境，在新环境中安装相关包。目录下，搜索已安装包的所有文件夹（包括包文件夹及其对应的。目录中，从而让 Suna 项目能正常部署。然后在新环境文件夹的。

所有其它包已经是最新版本。✅ 总共安装了3 个新包，并确认其余包已存在且是最新的。

✅ 所有依赖都已满足，并且cmake成功安装！

✅ 所有目标包都已成功重新安装或确认是最新的。

numpynumpy。

项目MINGW64 环境Clang64 环境终端名称Python 路径包名前缀是否适合你？✅ 若使用默认开发环境✅ 若用于跨平台编译是否支持降级✅ 加参数即可✅ 同样需要加参数。

⚠️ 如果遇到 pacman 拒绝降级，则在包名前加上“

mesonmeson。

关键点说明包命名规则根据功能区分python-前缀的使用隐含依赖安装时会自动拉取meson和推荐环境使用官方 Python 环境避免构建问题验证命令检查cythonninjameson的版本号。

Maturin是一个用于构建和发布 Python 包的工具，特别适用于使用Rust编写的 Python 扩展模块。它简化了将 Rust 代码编译为 Python 可用的.whl包的过程。构建wheel包支持支持交叉编译支持上传到 PyPI 或私有仓库工具是否成功版本号备注maturin✅ 成功1.8.6通过 pacman 安装，集成 Rust 和 Python 开发支持。

工具是否成功版本号备注pipx❌ 失败N/A与 pip 安装的库冲突numpy✅ 成功2.2.6-1重新安装pip✅ 成功25.1.1-1重新安装setuptools✅ 成功78.1.0-1重新安装wheel✅ 成功0.45.1-1正常安装。

工作记录。

步骤关键点使用 MSYS2 MINGW64提供完整的 GTK 库支持使用 Poetry 管理虚拟环境实现依赖隔离与精准控制指定 MINGW64 的 Python 解释器确保能找到 GTK 动态库测试 GTK 加载快速验证环境是否配置成功通过上述方法，我们成功地绕过了 Windows 系统下因 GTK 库找不到而导致的前端安装失败问题，为顺利部署 SUNA 类似的开源 AI Agent 项目提供了稳定可靠的解决方案。

通过基于 MSYS2（MINGW64）的 Poetry 虚拟环境解决suna部署的前端库的安装问题

在 MSYS2（MINGW64）中安装 Poetry 时，应优先使用pacman命令来确保系统的稳定性和兼容性。直接使用pip安装可能会带来不必要的麻烦和风险。

操作命令安装 pip查看 pip 版本安装官方 Python 包pacman -S mingw-w64-x86_64-python-包名创建虚拟环境使用 pipx 安装工具pacman -S mingw-w64-x86_64-python-pipx && pipx install 包名。

工作记录。

Suna 是一个完全开源的 AI 助手，通过自然对话帮助用户轻松完成研究、数据分析等日常任务。它结合了强大的功能和直观的界面，能够理解用户需求并提供结果。其强大的工具包包括浏览器自动化、文件管理、网页抓取、命令行执行、网站部署以及与各种 API 和服务的集成，这些功能协同工作，使 Suna 能够通过简单的对话解决复杂问题并自动化工作流程。

工作记录。

工作记录。

根据官方文档指引，需通过 Windows 包管理工具Scoop安装 Supabase CLI。

Scoop是 Windows 系统的命令行包管理工具，类似 Linux 的aptyum，支持通过命令快速安装、更新、卸载软件，无需手动下载安装包，适合开发者高效管理工具环境。

工作记录。