pycharm 的 bin 目录必须手动添加到系统 path 才能通过命令行直接运行 pycharm64.exe、pycharm.bat 等启动脚本；否则会提示“不是内部或外部命令”或“command not found”。
PyCharm 的 bin 目录必须加进 PATH 才能用命令行启动
不配置，pycharm64.exe、pycharm.bat 这些命令在任意目录下都执行不了。Windows 下 PATH 是系统级查找路径，PyCharm 安装后不会自动添加，得手动补上。
常见错误现象：'pycharm64.exe' 不是内部或外部命令，或者 command not found: pycharm（macOS/Linux）。
- 先确认 PyCharm 安装路径，比如默认是
C:\Program Files\JetBrains\PyCharm\bin（Windows）、/opt/pycharm/bin（Linux）、/Applications/PyCharm.app/Contents/bin（macOS） - Windows：打开「环境变量」编辑界面，在「系统变量」里找到
Path，点击「新建」，粘贴上面的bin路径 - macOS/Linux：在
~/.zshrc或~/.bash_profile里追加一行：export PATH="$PATH:/Applications/PyCharm.app/Contents/bin"（macOS）或export PATH="$PATH:/opt/pycharm/bin"（Linux），然后运行source ~/.zshrc - 验证方式：新开一个终端，输入
pycharm64.exe（Windows）或pycharm.sh（Linux）或open -na "PyCharm.app"（macOS），能启动即成功
PYCHARM_PYTHON_PATH 不是全局环境变量，只对当前 shell 生效
这个变量用来指定 PyCharm 启动时默认使用的 Python 解释器路径，但它不是系统级配置，也不会影响项目内实际运行逻辑——它只决定 PyCharm 自身启动时“倾向用哪个解释器创建新项目”。
容易踩的坑：有人把它当成项目运行时的 Python 环境，结果发现代码里 import numpy 报错，其实跟这个变量完全无关。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- Windows：在 cmd 中运行
set PYCHARM_PYTHON_PATH=C:\Python39\python.exe（仅当前窗口有效） - macOS/Linux：在终端中运行
export PYCHARM_PYTHON_PATH=/usr/local/bin/python3，再执行pycharm.sh - 如果想永久生效，得把
export命令写进 shell 配置文件（如~/.zshrc），但注意：这仍只影响你从终端启动 PyCharm 的行为，不影响已打开的 PyCharm 实例
项目解释器和系统 PATH 是两回事，别混在一起
很多人以为把 Python 加进系统 PATH，PyCharm 就能自动识别；其实 PyCharm 启动后，会扫描 PATH 里的可执行文件，但只作为候选列表显示，不会自动选中。而且如果你 PATH 里有多个 python.exe（比如 Anaconda 和 CPython 并存），PyCharm 不会帮你判断哪个该用。
真实使用场景：你刚装好 Python 3.11，PATH 也配好了，但新建项目时 PyCharm 下拉菜单里没出现它——因为 PyCharm 没扫描到，或者扫描到了但没自动勾选。
- 解决方法：File → Settings → Project → Python Interpreter → 点右上角齿轮 → Add → System Interpreter → 点右侧三个点 → 手动定位到
python.exe（Windows）或python3.11（macOS/Linux） - 注意路径别选错：Windows 上必须选到
python.exe，不是文件夹；macOS/Linux 上推荐选/usr/local/bin/python3.11这类软链接，而不是/usr/local/Cellar/python@3.11/3.11.9/bin/python3.11这种 Homebrew 的深层路径（容易因重装失效） - 如果选的是 Conda 环境，Base interpreter 必须指向
anaconda3/envs/myenv/python.exe，而不是根目录下的python.exe
PyCharm 启动脚本权限问题在 Linux/macOS 上很常见
Linux 和 macOS 用户常遇到 Permission denied 错误，尤其当你用 ln -s 创建符号链接后直接运行 pycharm 却失败。
根本原因：pycharm.sh 是 Shell 脚本，需要可执行权限；而符号链接本身没有执行权，依赖目标文件是否可执行。
- 检查权限：运行
ls -l /opt/pycharm/bin/pycharm.sh，看有没有x（如-rwxr-xr-x） - 如果没有，运行
chmod +x /opt/pycharm/bin/pycharm.sh - 符号链接创建后，建议用
ls -l /usr/local/bin/pycharm确认它确实指向正确的pycharm.sh，而不是某个中间目录或拼写错误的路径 - macOS 上如果弹出“无法验证开发者”警告，需右键 App →「打开」绕过一次 Gatekeeper，后续就不会再拦
print("hello") 都报错。
