如何使用Python脚本无第三方依赖修改用户.bash_aliases文件

核心问题根因 #

你遇到的所有问题本质是sudo运行时的环境变量切换、shell重定向的权限逻辑两个常见误区导致的：

• 用sudo运行程序时，系统会自动将HOME环境变量切换为root用户的home目录，因此~路径展开会指向root的配置目录
• sudo echo xxx >> file这类命令的重定向操作由当前未提权的普通用户shell执行，而非sudo后的提权进程，因此会出现权限不足报错

解决方案 #

根据你的脚本是否需要root权限，分为两种实现方式，均仅使用Python标准库，无需额外安装第三方依赖：

场景1：脚本不需要root权限，仅修改当前用户的配置 #

直接不用sudo运行脚本，通过路径展开直接写入即可，普通用户默认对自己home目录下的.bash_aliases有写入权限：

import os

# 自动展开当前用户的.bash_aliases路径
alias_file = os.path.expanduser("~/.bash_aliases")
# 要追加的内容，注意末尾加换行符避免和原有内容粘连
add_content = "alias mycustomcmd='cd /opt/myproject'\n"

# 追加模式写入
with open(alias_file, "a", encoding="utf-8") as f:
    f.write(add_content)

运行命令：
python3 myscript.py

场景2：脚本需要root权限运行（如同步执行系统配置修改、软件安装等操作） #

通过sudo运行时保留的SUDO_UID、SUDO_GID环境变量识别原始调用用户，写入后修正文件归属权限即可：

import os
import pwd

# 读取sudo运行时的原始用户标识
sudo_uid = os.environ.get("SUDO_UID")
sudo_gid = os.environ.get("SUDO_GID")

if sudo_uid and sudo_gid:
    # sudo运行场景，获取原始用户的home目录
    user_info = pwd.getpwuid(int(sudo_uid))
    alias_file = os.path.join(user_info.pw_dir, ".bash_aliases")
else:
    # 普通运行场景，直接展开当前用户路径
    alias_file = os.path.expanduser("~/.bash_aliases")

add_content = "alias mycustomcmd='cd /opt/myproject'\n"

# 提权状态下直接写入文件
with open(alias_file, "a", encoding="utf-8") as f:
    f.write(add_content)

# sudo运行场景下修正文件归属，避免后续普通用户无法编辑该配置
if sudo_uid and sudo_gid:
    os.chown(alias_file, int(sudo_uid), int(sudo_gid))

运行命令：
sudo python3 myscript.py

额外说明 #

如果你的.bash_aliases归属root用户、普通用户无写入权限，直接使用场景2的方案即可，无需在脚本内处理sudo密码交互，直接运行时加sudo即可完成提权。

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