Pyxel 安装全流程从空环境到跑通第一个像素游戏的 3 条路线【免费下载链接】pyxelA retro game engine for Python项目地址: https://gitcode.com/GitHub_Trending/py/pyxel浏览器里打开就能玩 Pyxel 像素游戏不用装任何东西本地开发则是一条 pip 命令装完再跑一条 pyxel run游戏窗口就弹出来了。Pyxel 按老式游戏机的规格设计16 色调色板、4 个声音通道直接写 Python 就能用。Pyxel 快速上手的最短路径其实只有三条命令下面按路线组织只想试玩走浏览器要写代码走 pip装不上走源码。每条路线都有明确的成功标志你随时知道自己走到哪一步了。30 秒选路线你该走哪条先别急着敲安装命令对照下你的目标你的情况路线成本只想试玩示例、写几行代码感受一下浏览器零安装打开页面即用要长期写 Python 游戏代码本地 pip 安装1~2 条命令pip 装不上 / 想源码编译最新版源码构建clone make约 10 分钟大多数读者选中间一行直接跳到第二条路线。最后一行是退路不是起点。路线一浏览器零安装打开就用 Pyxel 的 Web 版不需要 Python 环境。Code Maker 是浏览器内的代码编辑器写完点 Run游戏直接在页面里跑起来Launcher 里列着一批现成的可玩示例MML Studio 负责芯片音乐制作。打开浏览器就能用手机上也行。想把 Pyxel 游戏嵌进自己的网页看 docs/web-usage.md。注意浏览器里第一次运行要先点一下画面解锁音频否则没有声音。路线二本地 pip 安装 前置条件装好 Python 3.11 或更高版本。如果是 Pyxel Windows 安装装 Python 时记得勾选 Add python.exe to PATH否则 pyxel 命令不认。这条命令装引擎本体和全部依赖pip install -U pyxel成功时终端最后一行是Successfully installed pyxel-x.x.x没有红色报错。再跑这条命令验证安装结果pyxel看到版本号加a retro game engine for Python一行、下面列出可用命令清单Pyxel 配置就算完成了。一个常见疑问Linux 上要不要先装 SDL2不用。pip 装的是预编译 wheel不需要处理系统依赖libsdl2-dev那套只在源码构建时才有用。跑通第一个游戏 有了 pyxel 命令先跑这条把完整示例库拉到本地pyxel copy_examples成功时会打印一串copied pyxel_examples/...当前目录多出pyxel_examples文件夹。然后运行 Hello World 示例pyxel run pyxel_examples/01_hello_pyxel.py弹出 160x120 的窗口Hello, Pyxel! 文字逐帧变换 16 种颜色按 Q 键游戏退出——这就是 Pyxel 安装成功的标志。想自己写一个把下面 13 行存成hello.py再执行pyxel run hello.pyimport pyxel pyxel.init(160, 120, title我的第一个游戏) def update(): if pyxel.btnp(pyxel.KEY_Q): pyxel.quit() def draw(): pyxel.cls(0) pyxel.text(55, 41, Hello, Pyxel!, pyxel.frame_count % 16) pyxel.run(update, draw)成功时窗口弹出、文字颜色逐帧变化和示例的效果一致。开发时改用pyxel watch它会盯着目录保存文件就自动重载游戏改完即玩。卡住了两条退路 退路一源码构建如果你的环境没有预编译 wheel老系统、非标准 Python 版本pip 会报错此时改走源码构建。先克隆仓库git clone https://gitcode.com/gh_mirrors/py/pyxel成功时当前目录多出一个pyxel文件夹。Linux 上先装编译所需的依赖sudo apt install libsdl2-dev clang libclang-dev执行完没有报错输出说明依赖就绪。再进入目录执行make build编译结束后用这条命令验证能正常导入python -c import pyxel; print(pyxel.__version__)打印出版本号即成功。完整工具链清单cmake、rustup、node.js 等见 Makefile。退路二VS Code 扩展直接写完全不想碰环境的话在 VS Code 里装 Pyxel 扩展扩展自带运行时不装 Python 也能写、跑 Pyxel 代码是仅次于浏览器的轻开发路径。跑通之后编辑器和示例库引擎跑起来后下一件该碰的事是内置编辑器执行pyxel edit图像、瓦片地图、声音、音乐四个编辑器在一个窗口里做好的素材可以直接被代码加载。示例目录里还有能玩的完整游戏。进入pyxel_examples/apps执行pyxel play megaball.pyxapp一个可玩的街机游戏就弹出来了。这类 .pyxapp 是打包好的游戏文件你自己做出游戏后也可以用pyxel package打包给别人玩。下一步做三件事把 160x120 窗口里加一个会动的精灵方向键控制它移动示例 02_jump_game.py 里的跳跃逻辑可以直接抄打开pyxel edit画一个 8x8 精灵存成 png 再在代码里 load 出来做出能玩的小游戏后用pyxel package打包发给朋友更多示例和教程在 README.mdexamples 目录里每个示例之间只差一点点代码。【免费下载链接】pyxelA retro game engine for Python项目地址: https://gitcode.com/GitHub_Trending/py/pyxel创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考