### 如何在 PyCharm 中添加模块路径 为了使 Python 解释器能够找到所需的模块，可以通过配置 `$PYTHONPATH` 或者通过 PyCharm 的设置界面完成操作。以下是具体方法： #### 方法一：通过 `Preferences` 添加模块路径 PyCharm 提供了一种直观的方式让用户手动指定额外的模块路径。这可以在项目的偏好设置中实现。 1. 打开 **Settings/Preferences** 对话框 (快捷键通常是 `Ctrl + Alt + S`)。 2. 导航到 **Project: [Your Project Name] > Python Interpreter**。 3. 在右上角点击齿轮图标 (`⚙️`) 并选择 **Show All...**。 4. 选中当前使用的解释器并点击右侧的小文件夹图标 (**Add**) 来添加自定义路径[^1]。 5. 浏览并选择目标目录后确认即可。 此过程会将选定的路径加入到 Python 解释器的环境变量中，从而允许程序访问该路径下的模块。 #### 方法二：修改系统级别的 `$PYTHONPATH` 如果希望全局生效而不仅仅是针对单个项目，则可以调整操作系统层面的 `$PYTHONPATH` 变量。对于 Linux 用户来说，可以直接编辑 `.bashrc` 文件或者运行如下命令临时更改环境变量: ```bash export PYTHONPATH="${PYTHONPATH}:/path/to/modules" ``` 另外，在某些情况下也可以直接利用 Python 脚本内部动态扩展搜索范围的方法，即向 `sys.path` 列表追加新条目。例如： ```python import sys sys.path.append('/home/user/projects/my_module') ``` 这种方法虽然简单有效，但仅适用于脚本执行期间，并不会持久化影响其他地方调用的结果[^3]。 #### 方法三：借助 Packages 工具窗管理依赖库 自从版本更新以来（如2021版），PyCharm 新增了专门用于管理和浏览已安装包的工具窗口——Packages Tool Window[^2]。它不仅方便查看现有资源情况，还支持一键式新增所需第三方库的操作流程简化工作负担。 --- ### 示例代码展示如何动态增加模块路径 下面是一个简单的例子演示怎样通过编程手段扩充可导入模块的位置集合： ```python # 动态添加模块路径示例 import sys def add_custom_path(path_to_add): """ 将给定路径添加到系统的模块搜索列表 """ if path_to_add not in sys.path: sys.path.insert(0, path_to_add) if __name__ == "__main__": custom_module_dir = '/absolute/path/to/custom_modules' add_custom_path(custom_module_dir) # 验证是否成功添加 print(f"Updated Module Search Path:\n{sys.path}") ``` 上述函数实现了把特定位置优先级提升至最高处的功能效果。 ---