常见问题¶
本页汇总传习社工具、开发环境与基础设施相关的通用问题。
只涉及 GitLab / Git / SSH 的问题，请优先查看 GitLab FAQ。
文档站¶
文档内容有错误或缺失怎么办？¶
文档源文件在 GitLab 的 cx-studio/docs 仓库。可以直接提交 Issue 说明问题，或按 开发规范 提分支修改后发起 Merge Request。
为什么有些内部信息在文档里找不到？¶
本站是公开文档。服务器凭据、网络拓扑、备份策略、各类 Token 等内部信息不会出现在这里，它们存放在私有 infra 仓库中。有需要时请联系社内负责人。
账号与权限¶
我该在哪里注册账号？¶
GitLab 账号在 https://git.cx-studio.tech 自行注册，注册后需要管理员审核。详见 注册与登录。
我能创建自己的仓库吗？¶
可以。登录 GitLab 后通过 New project 创建仓库，用于个人实验或社团项目。会被多人共同维护的项目建议放在社团 group 下，便于统一管理。
没有权限访问某个仓库怎么办？¶
联系该仓库的维护者或社内负责人，将你的账号加入项目成员。
网络¶
校内和校外的访问方式有什么区别？¶
| 场景 | 推荐方式 |
|---|---|
| 校园网内 | SSH 内网入口 ssh://git@10.223.24.16:2201/...，速度最快 |
| 校外 | HTTPS https://git.cx-studio.tech/... |
内网 SSH 入口仅允许校园网环境访问。
网页能打开，但 Git 操作很慢？¶
公网访问需要经过 Cloudflare Tunnel，速度受线路影响。在校园网内切换到 SSH 内网入口可以明显改善，详见 GitLab FAQ。
开发环境¶
需要安装什么工具？¶
最基础的是 Git。安装方式：
# macOS
brew install git
# Debian / Ubuntu
sudo apt install git
# Windows
# 下载并安装 Git for Windows：https://git-scm.com/download/win
验证安装：
具体项目可能还需要其他运行环境（Node.js、Python 等），以各项目自己的说明为准。
推荐的编辑器是什么？¶
没有强制要求。VS Code、JetBrains 系列、Vim 都可以。建议至少在编辑器中配置：
- 显示行尾空白与缩进；
- 保存时自动去除行尾空格；
- 显示当前分支。
Windows 上用 PowerShell 还是 Git Bash？¶
两者都可以。执行本手册中的命令时，Git Bash 与文档中的示例更一致，遇到问题也更容易排查。
其他¶
遇到文档里没写的问题怎么办？¶
按下面的顺序尝试：
- 在本文档站搜索关键词；
- 查看 GitLab FAQ；
- 在 GitLab 对应仓库提交 Issue，说明你遇到的现象和已经尝试过的操作；
- 在社内群向其他成员求助。
我可以帮忙完善文档吗？¶
可以，而且欢迎。改动通过 Merge Request 提交，流程见 Issue 与 Merge Request。