github免费账户支持无限私有仓库(限三人协作者),需登录后在billing and plans确认free计划;创建时勾选private;本地项目需git init后关联远程并推送;添加协作者须手动邀请;私有库访问未授权时返回404。

如果您希望在 GitHub 上保存代码但不对外公开,则需要创建私人仓库。以下是创建和使用 GitHub 私有仓库的具体步骤:
一、确认账户权限与订阅状态
GitHub 免费账户已支持无限数量的私有仓库,但仅限最多三人协作者。创建私有仓库前需确保登录的是个人账户且未处于组织限制模式。
1、访问 https://github.com/login 并使用您的 GitHub 账户登录。
2、点击右上角头像,选择 Settings 进入账户设置页。
3、在左侧菜单中点击 Billing and plans,确认当前计划显示为 Free 且下方注明 Unlimited private repositories。
二、通过网页界面创建私有仓库
这是最直接的方式,适用于首次创建或临时新建仓库的场景,所有设置均可在表单中一次性完成。
1、登录后点击导航栏右上角的 + 号,选择 New repository。
2、在 Repository name 栏输入仓库名称,例如 my-private-project。
3、勾选 Private 单选按钮(位于 Public 按钮右侧)。
4、可选:勾选 Add a README file 或 Add .gitignore,但不建议同时勾选 Add a license(私有项目通常无需开源许可)。
5、点击 Create repository 完成创建。
三、通过命令行初始化已有本地项目为私有仓库
当您已有本地代码目录并希望将其关联至新的 GitHub 私有仓库时,需手动配置远程地址并推送。此方式跳过网页初始化步骤,适合开发者工作流。
1、在本地项目根目录打开终端,执行 git init 初始化 Git 仓库。
2、执行 git add . 将全部文件加入暂存区。
3、执行 git commit -m "Initial commit" 提交初始版本。
4、登录 GitHub 网页端,按“二”中步骤创建一个空的私有仓库(不勾选任何初始化选项),复制其 HTTPS 或 SSH 地址。
5、在终端中执行 git remote add origin https://github.com/your-username/repo-name.git(将地址替换为实际值)。
6、执行 git branch -M main 确保主分支名为 main。
7、执行 git push -u origin main 推送代码至私有仓库。
四、设置私有仓库的协作者权限
私有仓库默认仅创建者拥有读写权限。如需他人参与开发,必须显式添加协作者并指定权限级别,否则无法克隆或推送。
1、进入目标私有仓库页面,点击右上角 Settings 选项卡。
2、在左侧边栏中点击 Collaborators and teams。
3、点击 Add a collaborator 输入对方 GitHub 用户名。
4、对方将收到邀请邮件,需点击链接接受后,才可在该仓库执行 git clone 或 git push 操作。
5、管理员可在同一页面点击协作者姓名后的 … 图标,将权限从 Write 改为 Read 以限制推送权限。
五、验证私有仓库的访问控制有效性
GitHub 私有仓库不会出现在搜索结果中,且未经授权用户尝试访问会触发 404 页面而非权限拒绝提示,这是其隐私保护机制的一部分。需主动验证是否生效。
1、在已登录状态下,用浏览器无痕窗口访问该私有仓库 URL,例如 https://github.com/your-username/private-repo。
2、若页面显示 404 Not Found,说明私有设置已生效;若显示仓库内容,则可能误设为公开或存在组织可见性例外。
3、使用另一台未登录 GitHub 的设备或不同账户尝试访问同一 URL,确认返回结果仍为 404。
4、在本地执行 git clone https://github.com/your-username/private-repo.git,若提示 Authentication failed 或要求输入密码/令牌,则表明访问受控正常。










