Follow a checklist to configure a new Mac for software development from initial unboxing
Apply recommended trackpad, keyboard repeat, and function key settings to speed up daily developer workflows
Set up consistent keyboard shortcuts and environments across a pair-programming team
Automate Mac setup using command-line tools rather than clicking through system preferences manually
Steps must be applied manually, some sections are labeled as strongly opinionated personal preferences.
This repository is a personal guide, written in Chinese, for configuring a Mac to work as efficiently as possible. The author originally wrote it in 2015 on a 2013 MacBook Pro running OS X El Capitan, updated it in 2019 for a newer machine running macOS Catalina, and updated it again in 2024 for an M3 Max MacBook Pro on macOS Sonoma. An English version is linked from the top of the document. The guide reflects one developer's preferences and is openly labeled as opinionated in certain sections. The author's four guiding principles are: automation (use a command to install things rather than clicking through a website), consistency (keep keyboard shortcuts and environments the same across a team, especially when pair programming), using built-in tools where they are sufficient, and prioritizing speed throughout. The guide covers macOS system settings first, walking through trackpad configuration, how to turn function keys into standard F1-F12 keys for developer tools, enabling full keyboard navigation in dialog boxes, adjusting cursor repeat speed, and configuring input method switching shortcuts. Beyond system settings, the guide covers how to remove all fixed icons from the Dock so only currently open apps appear, how to reset Launchpad icon order to system defaults, and how to set Safari to reopen all windows from the last session. It also includes a terminal command to view current battery charging wattage, and tips for using the built-in macOS text-to-speech command for task notifications. The guide is structured as a living document the author continues to update as macOS changes. Readers are invited to submit their own tips through GitHub Issues or pull requests. Sections marked with [OCD] reflect particularly strong personal preferences, and the author notes that readers who disagree with those choices should feel free to skip them.
← macdao on gitmyhub — every repo by this author, as a profile.
Verify against the repo before relying on details.