IntelliJ本地项目创建GitHub仓库教程及公钥权限报错解决

一、本地项目初始化Git仓库 #

• 打开你已创建好的IntelliJ Java项目，点击顶部菜单栏的 VCS → Create Git Repository
• 在弹出窗口中选择当前项目的根目录，点击OK，项目即被初始化为Git本地仓库
• 右键项目根目录，选择Git → Add，将所有文件添加至暂存区
• 再次右键项目根目录，选择Git → Commit Directory，填写提交信息（比如Initial commit），点击Commit完成本地提交

二、在GitHub创建空远程仓库 #

• 登录GitHub账号，点击右上角的+ → New repository
• 填写仓库名称，设置可见性（公开/私有），重要提示：不要勾选Add a README file、Add .gitignore、Choose a license这三个初始化选项，直接点击Create repository
• 仓库创建完成后，复制页面中的SSH地址（格式为git@github.com:你的用户名/仓库名.git），也可选择HTTPS地址

三、在IntelliJ中关联远程仓库并推送代码 #

• 返回IntelliJ，点击顶部菜单栏的Git → Manage Remotes
• 在弹出窗口中点击+号，Name栏填写origin，URL栏粘贴刚才复制的GitHub仓库地址，点击OK保存
• 点击Git → Push，确认提交信息和分支后，点击Push即可完成代码推送

四、解决Permission denied (publickey)报错 #

该错误是由于本地未配置GitHub SSH密钥，导致无法通过SSH协议访问仓库，解决步骤如下：

• 打开本地终端（Windows用PowerShell，Mac/Linux用系统终端），执行命令：

  ssh-keygen -t ed25519 -C "你的GitHub注册邮箱"
  

  按提示一路回车即可，无需设置密码（按需设置也可），完成密钥生成
• 找到生成的公钥文件：Windows路径为C:\Users\你的用户名\.ssh\id_ed25519.pub，Mac/Linux路径为~/.ssh/id_ed25519.pub，用文本编辑器打开并复制全部内容
• 回到GitHub，点击右上角头像 → Settings → SSH and GPG keys → New SSH key
• Title栏填写一个标识名称（比如本地机器密钥），Key栏粘贴刚才复制的公钥内容，点击Add SSH key
• 返回IntelliJ重新执行Push操作，即可成功提交代码

内容的提问来源于stack exchange，提问作者Roy Huang