还在为CIA装不上发愁？一文帮你搞定3DS游戏格式转换，免费开源只需一条命令

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv

收藏游戏这件事，最磨人的往往不是花钱，而是格式。我手里的CCI（卡带镜像）装不进3DS，机器只认CIA（可直接安装的安装包格式），这中间的CCI转CIA，也就是3DS游戏格式转换，一度让我抓狂，直到朋友塞给我一个叫3dsconv的开源工具。那天我盯着报错屏幕到凌晨，才意识到问题根本不在游戏，而在格式本身。于是有了这篇文章——我踩过的坑，你不用再踩一遍。

三句话认识3dsconv：它到底是什么

三句话就能讲清楚：

• 它是什么：一个纯Python写的命令行工具，核心只有一个脚本文件，负责把任天堂3DS的CCI文件（扩展名是.3ds或.cci）转成CIA格式。
• 它能做什么：加密的、没加密的卡带镜像都能处理。加密的它自己判断类型，自动选择对应的解密策略，你几乎不用干预。
• 为什么值得用：免费、开源、跨平台，Windows、macOS、Linux都能跑，装完依赖后一条命令搞定。

打个比方，格式转换就像请了一位翻译官：你的卡带镜像说的是"外语"，CIA才是3DS听得懂的"母语"，而3dsconv就是那个随叫随到的翻译官，把话翻完还不收钱。

💡 小提示：现在GodMode9这类工具已经可以直接把卡带转储成CIA，3dsconv更擅长的是处理你手里早就存好的旧镜像，老玩家手里谁没几百个.3ds文件呢。

第一次转换CIA的具体步骤：三步跟着做

别急着研究原理，先跑通一次，后面什么都好说。

第一步：把工具拿到手

打开终端，克隆项目并安装唯一依赖：

git clone https://gitcode.com/gh_mirrors/3d/3dsconv cd 3dsconv pip install pyaes

pyaes是解密时用的AES算法库，整个工具就靠这一个第三方依赖，轻得不像话。

第二步：转一个文件试试

python3 3dsconv/3dsconv.py my_game.3ds -o my_game.cia

一个文件就一条命令，输出文件名自动跟随输入文件，不用自己改名。屏幕开始滚动输出进度，耐心等它跑完就行。

第三步：写个验证脚本，确认一切正常

把下面这段存成verify.py，运行python3 verify.py：

import subprocess result = subprocess.run( ['python3', '3dsconv/3dsconv.py', '--help'], capture_output=True, text=True ) if 'Convert Nintendo 3DS CCI' in result.stdout: print('✅ 安装成功，工具已就位') else: print('❌ 出问题了，回头检查安装步骤')

看到✅就说明环境没问题，可以放心开始转换大业了。

进阶玩法：三个场景里的实用技巧

跑通一次之后，你可能就跟我一样，开始琢磨怎么用得顺手。下面三个场景是我最常用的姿势。

场景一：给游戏收藏建档，别让转换结果散落一地

默认情况下，CIA会生成在当前目录。转多了之后，桌面和下载文件夹里全是文件，找起来头疼。用--output=指定输出目录，一步到位：

python3 3dsconv/3dsconv.py my_game.3ds --output=cia_library/

我习惯建一个cia_library/目录，按主机、按系列归档，多年收藏也能井井有条。再配合--verbose看详细日志，哪个文件转了多久、有没有警告，一目了然。

场景二：批量整理卡带镜像，一次命令全搞定

收藏家最爽的时刻，就是批量处理。3dsconv支持一次传多个文件：

python3 3dsconv/3dsconv.py game1.3ds game2.3ds game3.3ds --output=cia_library/

一口气转完三个，命令行自动逐个处理。Windows用户还有隐藏福利：直接把CCI文件拖到3dsconv.exe图标上就能转，不用敲命令。批量转完记得核对一下输出目录的文件数量，和输入对得上再收工，避免漏转。

场景三：加密游戏怎么办？boot9.bin的来龙去脉

大部分正版卡带镜像都是加密的，这时候转换需要一份ARM9 bootROM转储文件boot9.bin。听起来复杂，用起来其实很简单——你只需要把它放在当前目录，3dsconv会按这个顺序自动寻找：

1. --boot9=参数明确指定的路径
2. 当前目录下的boot9.bin
3. 当前目录下的boot9_prot.bin
4. ~/.3ds/目录下的两份

也就是说，把boot9.bin往当前目录一丢，剩下的交给工具。这份文件可以从你自己的3DS上用boot9strap转储（开机按住 START+SELECT+X 进入界面后导出），属于个人机器的密钥，注意别外传。

💡 如果你在做自制软件，或者手上有开发者版机器，记得加--dev-keys参数用开发者密钥转换，同时需要certchain-dev.bin证书链文件。要注意的是，转出的CIA仍带着开发者加密，只能在开发机上安装，别拿错密钥。

避坑手记：我替你踩过的四个坑

以下每条都是我真实翻过车的经历，帮你把时间省下来。

踩坑一：报"加密检测失败"，卡了我半小时

最后发现boot9.bin放错目录了。先检查文件是不是在当前目录，或者直接用--boot9=文件路径明确指定，别让工具猜。

踩坑二：转完了，输出目录里却没出现新文件

同名文件默认不覆盖。要么手动删掉旧的，要么加--overwrite让工具直接覆盖，省得来回折腾。

踩坑三：提示哈希校验不过

说明文件在传输或转储过程中可能损坏了。先重新转储再转一次；实在没办法，加--ignore-bad-hashes强行转换，但装到机器上能不能正常玩，就得看运气了。

踩坑四：CIA装上了，却打不开

八成是区域问题——日版游戏装到美版机器上，系统不认。这是3DS主机的硬件限制，再厉害的工具也绕不过，老老实实找对应区域的版本才是正解。

写在最后：工具会过时，社区不会

3dsconv的作者把它开源出来，使用MIT许可证，意味着你可以随便看源码、随便改、随便拿去用。它不完美，README里作者也坦诚地说，现在的GodMode9等工具已经能直接从卡带转储成CIA，3dsconv更像一位"老将"，专为历史遗留的旧镜像站好最后一班岗。

但工具会过时，社区不会。如果你也想像我一样把收藏库整理得整整齐齐，就从这个工具开始吧。遇到问题、有了新想法，或者只是改进了某段代码，都可以去项目仓库提issue、提建议。开源世界最迷人的地方就在这——你踩过的坑，写成文档，就是后来者脚下的路。祝你早日把那一柜子卡带，都装进机器里。

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv