如何通过PyCharm社区版搭建团队共用Git中心仓库

背景与问题 #

本地已用Git管理两个独立项目：UTILS_DEV（工具集）和MY_FUNCTIONSLIB（可安装函数库），均存储在全组织服务器挂载的/export/dsl/目录下，各自拥有本地Git仓库。为实现团队协作，在团队服务器完成以下操作：

• 安装Git并创建git用户
• 最初尝试通过git clone /export/dsl/UTILS_DEV在/home/git/git_repo/下创建远程仓库，将仓库目录组权限设为staff（所有团队用户均属该组）
• 在PyCharm中配置远程仓库地址ssh://dsl@group-server/home/git/git_repo/UTILS_DEV时，无报错但无法保存配置，不过可通过PowerShell正常SSH登录dsl@group-server
• 后续已删除非裸仓库，改用git init --bare重建，计划将两个项目推至同一仓库的不同分支，但尚未解决远程连接问题

核心问题排查与修正步骤 #

1. 远程仓库的正确创建逻辑 #

最初用git clone创建的是非裸仓库，这类仓库默认禁止接收推送（需额外配置但不推荐），必须使用裸仓库作为远程协作仓库。每个独立项目应对应一个独立的裸仓库：

# 登录团队服务器，进入git用户目录
cd /home/git/git_repo/
# 为UTILS_DEV创建裸仓库（惯例以.git结尾区分）
git init --bare UTILS_DEV.git
# 为MY_FUNCTIONSLIB创建独立裸仓库
git init --bare MY_FUNCTIONSLIB.git

2. PyCharm远程配置失败的解决方法 #

• 权限校验与修复：虽然能SSH登录dsl@group-server，但Git操作依赖git用户的仓库权限，需确保仓库目录的组权限正确：

  # 递归设置仓库目录组为staff
  chgrp -R staff /home/git/git_repo/
  # 递归赋予组读写权限
  chmod -R g+rw /home/git/git_repo/
  # 确保git用户主目录允许staff组访问
  chmod g+x /home/git/
  

• 跳过PyCharm图形界面，用命令行配置远程：直接通过Git命令行给本地仓库添加远程，PyCharm会自动识别配置：

  # 进入本地UTILS_DEV仓库目录
  cd /export/dsl/UTILS_DEV
  # 添加远程仓库（注意用git用户而非dsl用户登录）
  git remote add origin ssh://git@group-server/home/git/git_repo/UTILS_DEV.git
  # 推送本地主分支到远程并关联
  git push -u origin main
  

• 检查PyCharm的Git与SSH配置：确认Settings > Version Control > Git中指定了正确的本地Git可执行文件；在Settings > Tools > SSH Configurations中预配置group-server的连接信息，避免手动输入地址出错。

3. 多项目协作的正确架构 #

不要将两个独立项目推至同一仓库的不同分支，这会导致代码边界模糊、版本管理混乱。正确做法是每个项目对应独立的远程裸仓库，团队成员按需克隆各自需要的仓库即可。若需统一管理，可考虑Git子模块或Monorepo架构，但对于小型团队的独立工具/库，分开仓库是更简洁的选择。

内容的提问来源于stack exchange，提问作者Don Levey