PyInstaller

本文针对Python项目使用PyInstaller打包后出现文件读取路径报错的问题，提供了完整的解决方案。文章首先给出基于uv和Windows的Python项目全生命周期命令速查表，涵盖初始化、依赖管理、运行、调试及打包等关键操作。核心部分详细解析了打包后路径失效的根源（PyInstaller将文件解压至临时目录），并提供了可直接复制的`get_resource_path`函数代码，用于兼容开发与打包环境。同时强调打包命令需配合`--add-data`参数携带外部资源文件。文章还区分了uv安装的Python解释器、Cursor编辑器插件及解释器选择三者的不同角色，并解释了Cursor如何通过项目内`.vscode/settings.json`文件实现多项目Python版本的自动记忆与切换。

该文提出“洋葱模型”来理解计算机环境的分层结构：底层为硬件和显卡驱动，其次为CUDA等系统工具，再上是Python等语言运行时，顶层才是项目依赖；多数报错源于跨层不兼容。面对Web3开发，技术栈涉及Solidity智能合约、TypeScript前端、Python后端及节点运维，环境管理应遵循“项目沙盒化”，采用uv、nvm或Docker隔离，避免全局安装。借鉴开源项目需先审计环境文件，关注提交时间并最小化启动。普通用户可双击exe，而开发者必须管控各层次。Python代码可用PyInstaller打包成独立exe，它会内嵌解释器与依赖，但无法打包硬件驱动，涉及GPU或CUDA时仍需用户在目标机器预装适配驱动，并需留意路径失效与杀毒误报。