装到一半提示没权限
多半是装进了系统目录。换一个有写入权限的位置重装，或者用管理员身份把安装器再跑一遍。
EACCES
~/ 安装三步
三步之内，把软件装到能用
点开任意一步，能看到这一步要做什么、需要先准备什么。三步走完，软件就在你的机器上跑起来了。
STEP 01 拿到稳定版安装包
在版本页取当前的 3.4 稳定版，对一眼文件大小和校验值，再开始安装。
去版本页取包
STEP 02 照着安装器走完
安装器按你的系统给出对应步骤，关键动作不超过 7 步，中途不需要改系统设置。
看分系统步骤
STEP 03 打开一次确认能用
看到主界面就算装好了。要是停在启动画面，按提示里的报错码就能翻到对应的处理办法。
按报错码查
~/ 稳定版 3.4
挂上“稳定版”三个字之前，它先被折腾过一遍
每个包在发布前都跑完 42 项安装兼容性用例，覆盖全新安装、覆盖升级和常见系统环境。全部走通才挂稳定版标记，给第一次装的人当默认选择。
- 版本
- 3.4 稳定版
- 适用系统
- Windows 10 / 11 · macOS 12 及以上 · Ubuntu、CentOS 等主流发行版
- 文件大小
- 128 MB
- SHA-256
- 8d1f4b7a2c9e63d05f18ab47c2e93b60d75c1a4e8f2b96d3c07a51e42b8d9c34
要给同事批量装、或者机器根本连不上外网，走企业内网版的离线包更省事；想一整年都停在同一个版本，选长期支持版。下载高峰会自动分流到 5 家镜像服务商。
~/ 报错自查
报错弹出来的那一刻，先按这三类对号
十二类常见安装报错都写成了逐步排查路径，一篇读下来三分钟左右。先看看你碰上的是不是下面这三种。
下载走一半就断
公司网络走代理时最常见。把代理地址填进安装器的网络设置，或者改用离线包，绕开这一环。
ERR_PROXY
启动时提示少组件
系统缺运行库。照文档里列出的清单补齐依赖，再重新启动一次，通常就过去了。
LIB_MISSING
~/ 更新节奏
每周三，站里会多一期变更记录
安装包的改动、文档的修订、检索索引的更新，都集中在这一天对外。定期来看一眼，就知道自己手上这个版本要不要换。
一
二
三发布
四
五
六
日
从站点上线到现在，这个节奏一直没断过，累计已经发布 320 余期。最近一期改动就在本周三，翻一下就知道有没有你等的那个修复。
看最近的更新公告
~/ 背后的人
这些步骤，有人一条条装着试过
内容团队一共 9 个人，其中 4 个专门做安装测试和文档校验：文档里的每一步，都要先在真机上走通再发出去。剩下的人管检索索引、公告发布和用户答疑。
所以你照着文档走的时候，看到的是别人已经踩过一遍的路径。真碰上文档里没写的情况，写封信过来，工作日内会有人回你。
认识这条服务线- 4 安装测试与文档校验 每条步骤先在一台真机上跑通，再写进文档。
- 5 索引维护与用户答疑 整理报错关键词、发布每周公告、回复来信里的具体问题。
- 31 个省级行政区的用户来信 从一线城市到内网机房，问题五花八门，解法也跟着补齐。