os.path.join()拼接路径用法详解 - Python跨平台编程教程

os.path.join(path, *paths)

import os

path1 = os.path.join('home', 'user', 'documents')
print(f"多级路径: {path1}")

path2 = os.path.join('project', 'src', 'main.py')
print(f"文件路径: {path2}")

path3 = os.path.join('/usr', 'local', 'bin')
print(f"绝对路径: {path3}")

多级路径: home\user\documents
文件路径: project\src\main.py
绝对路径: \usr\local\bin

import os

# 当某个组件是绝对路径时，之前所有组件会被丢弃
result1 = os.path.join('/home', '/user', 'docs')
print(f"中间组件为绝对路径: {result1}")

result2 = os.path.join('base', 'sub', '/absolute')
print(f"最后组件为绝对路径: {result2}")

result3 = os.path.join('C:\\Users', 'project', 'file.txt')
print(f"Windows路径: {result3}")

中间组件为绝对路径: /user\docs
最后组件为绝对路径: /absolute
Windows路径: C:\Users\project\file.txt

import os

BASE_DIR = '/project'
dirs = {
    'src': os.path.join(BASE_DIR, 'src'),
    'tests': os.path.join(BASE_DIR, 'tests'),
    'docs': os.path.join(BASE_DIR, 'docs'),
    'config': os.path.join(BASE_DIR, 'config'),
    'main': os.path.join(BASE_DIR, 'src', 'main.py'),
}

for name, path in dirs.items():
    print(f"{name}: {path}")

src: /project\src
tests: /project\tests
docs: /project\docs
config: /project\config
main: /project\src\main.py

import os

def build_safe_path(base_dir, *components):
    """
    安全地构建路径，确保结果在base_dir范围内
    防止路径遍历攻击（../）
    """
    # 拼接路径
    result = os.path.join(base_dir, *components)
    # 规范化路径（解析..和.）
    result = os.path.normpath(result)
    # 确保结果在base_dir范围内
    abs_base = os.path.abspath(base_dir)
    abs_result = os.path.abspath(result)
    
    if not abs_result.startswith(abs_base):
        raise ValueError(f"路径 {result} 超出允许的范围")
    
    return abs_result

# 使用示例
try:
    safe = build_safe_path('/data', 'uploads', 'image.png')
    print(f"安全路径: {safe}")
    
    # 这会抛出异常
    dangerous = build_safe_path('/data', '..', 'etc', 'passwd')
    print(f"危险路径: {dangerous}")
except ValueError as e:
    print(f"路径安全检查: {e}")

import os

BASE_DIR = os.path.join(os.getcwd(), 'my_project')
SRC_DIR = os.path.join(BASE_DIR, 'src', 'core')
CONFIG_DIR = os.path.join(BASE_DIR, 'config')

# 创建目录结构
for d in [SRC_DIR, CONFIG_DIR]:
    os.makedirs(d, exist_ok=True)
    print(f"创建目录: {d}")

# 在最内层创建文件
files = {
    os.path.join(SRC_DIR, 'app.py'): 'print("Hello from app!")',
    os.path.join(SRC_DIR, '__init__.py'): '',
    os.path.join(CONFIG_DIR, 'settings.ini'): '[app]\nname = MyApp',
}

for filepath, content in files.items():
    with open(filepath, 'w', encoding='utf-8') as f:
        f.write(content)
    print(f"创建文件: {filepath}")

print("\n目录结构创建完成！")

import os

# 对比两种拼接方式
components = ['project', 'src', 'main.py']

# 方式1：os.path.join()
correct_path = os.path.join(*components)
print(f"os.path.join(): {correct_path}")

# 方式2：字符串拼接（错误方式）
wrong_path = '/'.join(components)
print(f"字符串拼接:    {wrong_path}")

print(f"\n分析:")
print(f"Windows分隔符: {os.sep}")
print(f"os.path.join()结果使用正确的分隔符: {os.sep in correct_path}")
print(f"字符串拼接始终使用/: {'/' in wrong_path}")

# 验证
if os.name == 'nt':  # Windows
    expected = 'project\\src\\main.py'
else:  # Linux/macOS
    expected = 'project/src/main.py'
    
print(f"\n期望路径: {expected}")
print(f"os.path.join()结果正确: {correct_path == expected}")