如何切换Python包本地与已安装版本（含PyCharm IDE支持）

针对你开发的fhg_isi包，想要在本地0.0.2开发版本和已安装的0.0.1版本之间便捷切换，同时让PyCharm支持代码跳转，推荐以下几种方案：

1. pip可编辑模式安装（最推荐） #

这是Python生态中本地包开发的标准做法，既能让Python加载本地源码，又能被IDE完美识别：

• 打开终端，进入本地fhg_isi包的根目录（包含setup.py或pyproject.toml的文件夹），执行：

  pip install -e .
  

• 此时Python会优先使用本地的0.0.2版本，PyCharm的Ctrl+点击、自动补全都会直接指向本地源码文件。
• 要切回已安装的0.0.1版本，先卸载本地链接：

  pip uninstall fhg_isi
  

  再重新安装指定版本：

  pip install fhg_isi==0.0.1
  

2. PyCharm解释器路径配置（无需修改代码） #

直接通过IDE配置调整包的加载优先级，不用改任何代码：

1. 打开PyCharm的File > Settings > Project: [你的项目名] > Python Interpreter
2. 点击右上角齿轮图标，选择Show All
3. 选中当前使用的解释器，点击右侧的Show paths for the selected interpreter按钮
4. 在路径列表中点击+，添加本地包的src目录（比如C:/python_env/workspace/fhg_isi/src），并将该路径拖拽到列表最顶部（确保本地路径优先加载）
5. 切回已安装版本时，只需在路径列表中删除这个本地路径即可，IDE会自动使用site-packages里的0.0.1版本

3. 虚拟环境隔离（长期并行开发） #

如果需要长期同时维护两个版本，可以用虚拟环境彻底隔离：

• 创建第一个虚拟环境，安装已发布的0.0.1版本：

  # 假设用venv创建
  python -m venv env_stable
  # 激活环境后执行
  pip install fhg_isi==0.0.1
  

• 创建第二个虚拟环境，用可编辑模式安装本地0.0.2版本：

  python -m venv env_dev
  # 激活环境后进入本地包根目录执行
  pip install -e .
  

• 在PyCharm中通过File > Settings > Python Interpreter切换对应的虚拟环境，就能快速在两个版本间切换，完全无冲突。

关于你当前sys.path方法的补充 #

你用sys.path.insert的方式在运行时修改路径，PyCharm的静态代码分析不会识别这个动态添加的路径，所以Ctrl+点击会跳转到已安装版本。如果要继续用这个方法，需要在PyCharm的File > Project Structure中，把本地包的src目录添加为Sources，IDE才能识别本地代码，但这种方式需要手动维护代码和IDE配置，不如上面的方案便捷。

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